---
name: "above"
section: "3pm"
platform: "linux"
package: "libur-perl"
version: "0.470+ds-3"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/above"
---

# above(3pm)

auto "use lib" when a module is in the tree of the PWD

## 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