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 instructsmake_ppm
to ignore any test failures. - -b location
-
location is used as the value for the
BINARY_LOCATION
attribute passed toperl 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 toperl
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.