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

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

-f

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

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 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

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

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

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

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

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.

-h

This prints out a short help screen and exits.

-v

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.