table of contents
above(3pm) | User Contributed Perl Documentation | above(3pm) |
NAME¶
above - auto "use lib" when a module is in the tree of the PWD
SYNOPSIS¶
use above "My::Module";
DESCRIPTION¶
Used by the command-line wrappers for Command modules which are developer tools.
Do NOT use this in modules, or user applications.
Uses a module as though the cwd and each of its parent directories were at the beginnig of @INC. If found in that path, the parent directory is kept as though by "use lib".
Set ABOVE_DISCOVERY_ACROSS_FILESYSTEM shell variable to true value to crawl past device boundaries.
EXAMPLES¶
# given /home/me/perlsrc/My/Module.pm
# in /home/me/perlsrc/My/Module/Some/Path/
# in myapp.pl: use above "My::Module";
# does this ..if run anywhere under /home/me/perlsrc: use lib '/home/me/perlsrc/' use My::Module;
AUTHOR¶
Scott Smith Nathaniel Nutter
2024-06-15 | perl v5.38.2 |