Permits adding additional directories to Perl's default search path at compile
time. The directories are added at the front of the search path.

use lib
list
;

adds the directories specified in
list
to
@INC
.

For each directory
$dir
in
list
,
lib
looks for an
architecture-specific subdirectory that has an
auto
subdirectory
under it-that is, it looks for
$dir/$archname/auto
. If it finds
that directory, then
$dir/$archname
is also added to the front of
@INC
,
preceding
$dir
.

Normally, you should only
add
directories to
@INC
. However, you
can also delete directories. The statement:

no lib
list

deletes the first instance of each named directory from
@INC
. To
delete all instances of all the specified names from
@INC
, specify
:ALL
as the first parameter of
list
.

As with adding directories,
lib
checks for a
directory called
$dir/$archname/auto
and deletes the
$dir/$archname
directory from
@INC
. You
can restore
@INC
to its original value with: