Description:

This script generates an RPM package from a Perl module. It uses the
standard RPM file structure and creates a spec file, a source RPM,
and a binary, leaving these in their respective directories.

The script can operate on local files, directories, urls and CPAN
module names. Install this package if you want to create RPMs out of
Perl modules.

The syntax for cpan2rpm supports multiple *distribution* names, which
can take one of four different forms:

1. a CPAN module name (e.g. XML::Simple) - When a module name is passed,
the script will "walk" search.cpan.org to determine the latest distribution.
If an exact match is not found, the CPAN module is used to make
this determination. If you have not yet configured this module,
please refer to the REQUIREMENTS section below for further instructions.

2. a URL (both http:// and ftp:// style locators will work) -
In this and the above case, an automatic download of the needed tarball
is performed (see notes for how). The tarball is deposited in the SOURCES
directory.

3. a path to a tarball (e.g. /tmp/XML-Simple-1.05.tar.gz) -
In this case, the tarball indicated gets copied to the SOURCES directory.

4. a directory path - The directory specified must contain a Makefile.PL.
If the user intends to build a package from a directory
(i.e. user does NOT specify --spec-only), the commands:

perl Makefile.PL
make
make dist

will be performed in that directory in order to create the tarball
necessary for package creation.