NAME

ppm_install - script to build and install a distribution via ppm

SYNOPSIS

ppm_install [options] [Module | Distribution]

# install from within an already unpacked source distribution
C:\.cpan\build\package_src> ppm_install

# fetch from CPAN a module distribution and build a PPM
C:\.cpan\build> ppm_install Net::FTP

# fetch a distribution and build a PPM
C:\.cpan\build> ppm_install ftp://wherever.com/package.tar.gz

DESCRIPTION

ppm_install is an interface to the PPM::Make module, and is used to build a PPM (Perl Package Manager) distribution from a CPAN source distribution and then install it with the ppm utility. See PPM::Make for a discussion.

Apart from the options described below, without any arguments ppm_install will assume it is inside an unpacked source distribution and make the corresponding PPM distribution. If it is given an argument of what looks like a module name (eg, Net::FTP), it will use CPAN.pm to look up the corresponding distribution and fetch and build it. Otherwise, additional arguments (eg, package.tar.gz, or http://someplace.org/package.tar.gz) will be interpreted as distributions to fetch and build.

[-i | --ignore]

By default, ppm_install, if it is building the distribution, will die if all tests do not pass. Turning on this option instructs ppm_install to ignore any test failures.

[-r | --remove]

If specified, the directory used to build the ppm distribution given on the command line will be removed after a successful install.

[-h | --help]

This prints out a short help screen and exits.

[-v | --version]

This prints out some version information and exits.

COPYRIGHT

This program is copyright, 2003, by Randy Kobes <randy@theoryx5.uwinnipeg.ca>. It is distributed under the same terms as Perl itself.

SEE ALSO

PPM::Make, and PPM.