Makerpm.Txt

#!/usr/bin/perl -w
#
#
# makerpm.pl - A Perl script for building binary distributions
# of Perl packages
#
# This script is Copyright (C) 1999 Jochen Wiedmann
# Am Eisteich 9
# 72555 Metzingen
# Germany
#
# E-Mail: joe@ispsoft.de
#
# You may distribute under the terms of either the GNU General
# Public License or the Artistic License, as specified inthe
# Perl README.
#

use strict;

use Cwd ();
use File::Find ();
use File::Path ();
use File::Spec ();
use File::Basename ();
use Getopt::Long ();
use Config ();


use vars qw($VERSION);
$VERSION = "makerpm 0.1102 02-Jan-2000, (C) 1999 Jochen Wiedmann";

=pod

=head1 NAME

makerpm - Build binary distributions of Perl packages


=head1 SYNOPSIS

Create a SPECS file:makerpm --specs --source=-.tar.gz

Apply the SPECS file (which in turn uses makerpm.pl):

rpm -ba -.spec

Create a PPM and a PPD file:

makerpm --ppm --source=-.tar.gz


=head1 DESCRIPTION

The I script is designed for creating binary distributions of
Perl modules, for example RPM packages (Linux) or PPM files (Windows,
running ActivePerl).


=head2 Creating RPM packagesTo create a new binary and source RPM, you typically store the tar.gz
file in F (F in
case of SuSE and F in case of Caldera) and
do a

makerpm --specs --source=-.tar.gz

This will create a SPECS file in F
(F in case of SuSE and
F in case of Caldera) which you
can use with

rpm -ba /usr/src/redhat/SPECS/-.spec

If the default behaviour is fine for you, that will do. Otherwisesee
the list of options below.


=head2 Creating PPM packages

A PPM package consists of two files: The PPD (Perl Package description)
file which contains XML source describing the package details and the
PPM file which is nothing else than the archived blib directory.

You can create the package with

makerpm --ppm --source=-.tar.gz


=head2 Command Line Options

Possiblecommand line options are:

=over 8

=item --build

Compile the sources, typically by running

perl Makefile.PL
make

=item --build-root=

Installation of the Perl package occurs into a separate directory, the
build root directory. For example, a package DBI 1.07 could be installed
into F. Binaries are installed into F
rather than F, man pages in F and so on.

The idea is making thebuild process really reproducible and building the
package without destructing an existing installation.

You don't need to supply a build root directory, a default name is
choosen.

=item --copyright=

Set the packages copyright message. The default is

GNU General Public or Artistic License, as specified in the Perl README

=item --debug

Turns on debugging mode. Debugging modeprevents most things from really
being done and implies verbose mode.

=item --help

Print the usage message and exit.

=item --install

Install the sources, typically by running

make install

Installation doesn't occur into the final destination. Instead a
so-called buildroot directory (for example F)
is created and installation is adapted relative to that directory.
See the Ioption for details.

=item --make=

Set path of the I binary; defaults to the location read from Perl's
Config module. L.

=item --makeopts=

Set options for running "make" and "make install"; defaults to none.

=item --makemakeropts=

If you need certain options for running "perl Makefile.PL", this is
your friend. By default no options are set.

=item --mode=

Set build mode, forexample RPM or PPM. By default the build mode
is read from the script name: If you invoke it as I, then
RPM mode is choosen. When running as I, then PPM mode is
enabled.

=item --package-name=

=item --package-version=

Set the package name and version. These options are required for --build and
--install.

=item --prep

Extract the sources and prepare the source directory.

=item...