CPAN Module Distributions

CAUTION You might be tempted to start with a version like 0.1 instead of 

0.01, but that can cause problems later when you want to release a version 

after 0.9 but aren't ready for the psychological impact of releasing 1.0.

After the $VERSION assignment, h2xs includes the cryptic comment  preloaded 

methods go here.  You can read that as  your module code goes here.  The term 

 preloaded  is a reference to h2xs's support for the AutoLoader module, which 

makes a distinction between  preloaded  and  autoloaded  subroutines and methods

Finally, h2xs includes some example POD documentation after the requisite 

final true statement. The example POD contains the sections that most CPAN 

modules will need NAME, SYNOPSIS, DESCRIPTION, EXPORT, AUTHOR, and SEE ALSO. Of 

course, unless your module is very simple, you'll need to add sections that describe 

the available subroutines and methods. Also, unless your module uses the 

Exporter, it's safe to remove EXPORT.

An edited version of Counter.pm containing the code and documentation for 

the module is shown in Listing 4 2.

Listing 4 2. Modified Counter.pm for Data::Counter

package Data::Counter;

use 5.006;  # this will be checked in Makefile.PL too

use strict;

use warnings;

# make count() available for optional exporting

require Exporter;

our @ISA = qw(Exporter);

our @EXPORT_OK = (  count  );

our $VERSION =  0.01 ;

# return a count of arguments

sub count { 

  return scalar @_; 

}

1;

__END__

=head1 NAME

10

103

3