- cpan2rpm -

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, urls and CPAN module names.
Install this package if you want to create RPMs out of Perl modules.

- INSTALLATION -

cpan2rpm is distributed in RPM format.  To install: download the file
and issue the following command:

	rpm -Uvh cpan2rpm-x.xx-x.i386.rpm

Alternatively you can supply rpm with a url, like this:

	rpm -Uvh http://somelocation/cpan2rpm*.rpm

If a package for your platform is not available, download the .src RPM
and rebuild.  You can also simply download the tarball and rebuild it
like this:

	rpmbuild -ta cpan2rpm-*.tar.gz

after which the resulting package will be located in

	/usr/src/redhat/RPMS/<your-platform-here>

- NOTES -

1) cpan2rpm can fetch tarballs from URLs.  To do this it needs either LWP
installed, or the HTTP::Lite module.  If neither of these is available, the
system will try various external programs e.g. lynx, ncftp, etc.  You can
get an RPM of HTTP::Lite from our web site (the source RPM is also
available) but should the package not be available for your platform you
can also bootstrap it like this (thanks to Jim Radford for this suggestion):

	./cpan2rpm  HTTP::Lite
	rpm -Uvh .../HTTP-Lite-<version-release.arch>.rpm
	./cpan2rpm cpan2rpm-1.49.tar.gz
	rpm -Uvh .../cpan2rpm-1.49-1.i386.rpm

2) Additionally, to fix a problem with the rpm-build dependency generator,
we've included the file perl.req.patch which may need be applied as root.
For further information please see the docs for the --req-scan-all switch.
The patch may be applied as follows:

	sudo patch -p0 < perl.req.patch

3) Finally, for dependencies to work the RH requirements script must be
executable (at the time of this writing rpm-build ships without this
script in the correct mode).  You can do this with: 

	sudo chmod +x /usr/lib/rpm/perl.req

- DOCUMENTATION -

For full documentation see the accompanying man page or refer to

	http://perl.arix.com

- SUPPORT -

For help, please e-mail cpan2rpm@arix.com.  To subscribe to an
announcements mailing list, use the above address with the subject header
"subscribe" (or "unsubscribe" as the case may be).
