Chapter 4

Installing /usr/local/man/man3/Memoize.3

Installing /usr/local/man/man3/Memoize::ExpireTest.3

Installing /usr/local/man/man3/Memoize::Saves.3

Installing /usr/local/man/man3/Memoize::Expire.3

Installing /usr/local/man/man3/Memoize::AnyDBM_File.3

Installing /usr/local/man/man3/Memoize::Storable.3

Installing /usr/local/man/man3/Memoize::ExpireFile.3

Installing /usr/local/man/man3/Memoize::SDBM_File.3

Installing /usr/local/man/man3/Memoize::NDBM_File.3

Writing /usr/local/lib/perl5/site_perl/5.6.1/i686 linux/auto/Memoize/.packlist

Appending installation info to

/usr/local/lib/perl5/5.6.1/i686 linux/perllocal.pod

The amazing thing about this procedure is that it works for nearly every 

module on CPAN on nearly every operating system supported by Perl. Virtually 

every module on CPAN supports the exact same installation procedure. This 

chapter will explain in detail how each of these steps works and show you how to 

build a distribution that your users will be able to install as easily as Memoize.

Always Begin with h2xs

The Perl documentation on building a module distribution

3

 contains the excellent 

advice,  Start with h2xs.  The documentation for ExtUtils::MakeMaker,

4

 the module 

responsible for making Makefile.PL work, elaborates:

Always begin with h2xs.

Always begin with h2xs!

ALWAYS BEGIN WITH H2XS!

This is good advice because using h2xs can save you a lot trouble, and I'll show you 

how to follow it. Perl comes with a program called h2xs

5

 that can be used to generate 

the skeleton

6

 of a module distribution. Its rather obscure name comes from the fact 

that it was originally designed as a tool to generate XS

7

 modules from C header files.

3. perlnewmod, written by Simon Cozens

4. Written by Andy Dougherty, Andreas Koenig, Tim Bunce, Charles Bailey, and Ilya 

Zakharevich. It is included with Perl.

5. Written by Larry Wall and others. I'm using version 1.21.

6. No black magic required this just means that h2xs creates a set of mostly empty files for you 

to flesh out to complete your module distribution.

7. XS is the name for Perl's C language extension system. See Chapter 9 for details.

98