/ 
PPM-Make-0.28
River stage zero No dependents
/ make_ppm

NAME

make_ppm - script to make a PPM distribution

SYNOPSIS

make_ppm [options] [Module | Distribution]

# make a PPM from within an already unpacked source distribution
C:\.cpan\build\package_src> make_ppm 

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

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

DESCRIPTION

make_ppm is an interface to the PPM::Make module, and is used to build a PPM (Perl Package Manager) distribution from a CPAN source distribution. See PPM::Make for a discussion.

Apart from the options described below, without any arguments make_ppm 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.

Available options include:

[-z | --zip]

By default, make_ppm will build a .tar.gz distribution if possible. This option forces a .zip distribution to be made.

[-f | --force]

By default, if make_ppm detects a blib/ directory, it will assume the distribution has already been made, and will not remake it. This option forces remaking the distribution.

[-i | --ignore]

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

[-b | --binary] location

location is used as the value for the BINARY_LOCATION attribute passed to perl Makefile.PL, and is used in setting the HREF attribute of the CODEBASE field in the ppd file.

[-n | --arch_sub]

This option will insert the value of $Config{archname} (or the value of the -a option, if given) as a relative subdirectory in the HREF attribute of the CODEBASE field in the ppd file.

[-o | --os] os

If specified, this value will be used instead of the default for the NAME attribute of the OS field of the ppd file.

[-a | --arch] arch

If specified, this value will be used instead of the default for the NAME attribute of the ARCHITECTURE field of the ppd file.

[-s | --script] script

This will be used in the PPM_INSTALL_SCRIPT attribute passed to perl Makefile.PL, and arises in setting the value of the INSTALL field in the ppd file.

[-e | -- exec] exec

This will be used in the PPM_INSTALL_EXEC attribute passed to perl Makefile.PL, and arises in setting the EXEC attribute of the INSTALL field in the ppd file. This defaults to perl when a value of script is specified.

[-x | --add] file

This option, which can be specified multiple times, can be used to add additional files outside of the the blib directory to the archive.

[-l | --install]

If specified, the ppm utility will be used to install the module.

[-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, 2002, by Randy Kobes <randy@theoryx5.uwinnipeg.ca>. It is distributed under the same terms as Perl itself.

SEE ALSO

PPM::Make, and PPM.