Edit: /usr/share/perl5/pod/perlmodinstall.pod (10261B)
=head1 NAME
perlmodinstall - Installing CPAN Modules
=head1 DESCRIPTION
You can think of a module as the fundamental unit of reusable Perl
code; see L
for details. Whenever anyone creates a chunk of
Perl code that they think will be useful to the world, they register
as a Perl developer at L
so that they can then upload their code to the CPAN. The CPAN is the
Comprehensive Perl Archive Network and can be accessed at
L , and searched at L .
This documentation is for people who want to download CPAN modules
and install them on their own computer.
=head2 PREAMBLE
First, are you sure that the module isn't already on your system? Try
C. (Replace "Foo" with the name of the module; for
instance, C.)
If you don't see an error message, you have the module. (If you do
see an error message, it's still possible you have the module, but
that it's not in your path, which you can display with C.) For the remainder of this document, we'll assume
that you really honestly truly lack an installed module, but have
found it on the CPAN.
So now you have a file ending in .tar.gz (or, less often, .zip). You
know there's a tasty module inside. There are four steps you must now
take:
=over 5
=item B the file
=item B the file into a directory
=item B the module (sometimes unnecessary)
=item B the module.
=back
Here's how to perform each step for each operating system. This is
a substitute for reading the README and INSTALL files that
might have come with your module!
Also note that these instructions are tailored for installing the
module into your system's repository of Perl modules, but you can
install modules into any directory you wish. For instance, where I
say C, you can substitute C to install the modules into
F. Then you can use the modules from your Perl
programs with C