NAME

make_ppm_install - install a distribution within CPAN.pm via ppm

SYNOPSIS

make_ppm_install [options]

Options:

[ --no-cfg ]         : do not read a .ppmcfg configuration file
[ --force  ]         : force ppm to install a package
[ --nodeps ]         : ignore dependencies when installing a package
[ --area area ]      : install package into the specified area

DESCRIPTION

This is an experimental feature which requires version 1.92_56 or greater of CPAN.

make_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 install it via the ppm utility. See PPM::Make for a discussion of how the ppm package is made.

Although this script can be run from the command line inside a CPAN distribution directory for which the perl Makefile.PL, $MAKE, and $MAKE test commands have been carried out, it is mainly intended for use within CPAN as a substitute for $MAKE install. This can be done by specifying make_ppm_install as the make_install_make_command and the mbuild_install_build_command of CPAN::Config:

cpan> o conf make_install_make_command make_ppm_install
cpan> o conf mbuild_install_build_command make_ppm_install

Options to the ppm install command can be passed via make_install_arg and mbuild_install_arg; at present, these can be:

[ --no-cfg ]

Do not read a .ppmcfg configuration file specifying options to pass to PPM::Make.

[ --force ]

If the package or module requested is already installed, PPM installs nothing. The --force option can be used to make PPM install a package even if it's already present. With --force PPM resolves file conflicts during package installation or upgrade by allowing files already installed by other packages to be overwritten and ownership transferred to the new package. This may break the package that originally owned the file. This is available within PPM4 only.

[ --nodeps ]

The --nodeps option makes PPM attempt to install the package without resolving any dependencies the package might have. This is available within PPM4 only.

[ --area area ]

By default, new packages are installed in the "site" area, but if the "site" area is read only, and there are user-defined areas set up, the first user-defined area is used as the default instead. Use the --area option to install the package into an alternative location.

Also, when invoked from the command line, the following options are understood:

[--help]

This prints out a short help screen and exits.

[--version]

This prints out some version information and exits.

COPYRIGHT

This program is copyright, 2008, by Randy Kobes <r.kobes@uwinnipeg.ca>. It is distributed under the same terms as Perl itself.

SEE ALSO

PPM::Make.