I can't find where in the perl docs is says subdirs of @INC are searched automatically -- looked in perlmod, perlmodlib, and perlmodstyle.

Are not-explicitly-named subdirs of @INC searched?

(Of course  use Foo::Bar::Baz; needs to go into Foo/Bar/ to get to Baz, but that to me is explicit. I mean, you can't just say  use Baz; and expect perl to search down to find it, yes?

So, unable to find docs, and getting confusing test results (likely other errors), logic would indicate subdirs of @INC aren't automatically searched.

WOuld be delighted for someone authoritative to weigh in, or post a pointer to the docs where this is explained.

(One reason I am confused is that the code I am looking at -- which itself may not be correct, that's another issue -- seems to rely on the fact that

/usr/local/lib/site_perl/lib
[download]

is part of @INC, where (I think) only

/usr/local/lib/site_perl
[download]

is.)

Confused I am.