Chapter 4

Table 4 1. Files Generated by h2xs

File

Description

Counter.pm

The module file itself, containing Perl code and POD 

documentation

Makefile.PL

A script that uses ExtUtils::MakeMaker to generate a Makefile

test.pl

A test script run when a user enters  make test  or installs 

your module with the CPAN module

README

A quick description of your module and how to install it

Changes

A change log where you can describe differences between 

versions of your module

MANIFEST

A list of all the files in your distribution

Counter.pm The Module File

The module file generated by h2xs (see Listing 4 1) is a generic template into which 

I'll place the code and documentation for Data::Counter. However, before I blow 

away what's there, let's look at the generated template; it uses some features that 

might be new to you.

Listing 4 1. Counter.pm File Generated by h2xs

package Data::Counter;

use 5.006;

use strict;

use warnings;

require Exporter;

our @ISA = qw(Exporter);

# Items to export into callers namespace by default. Note: do not export

# names by default without a very good reason. Use EXPORT_OK instead.

# Do not simply export all your public functions/methods/constants.

# This allows declaration       use Data::Counter  :all ;

# If you do not need this, moving things directly into @EXPORT or @EXPORT_OK

# will save memory.

our %EXPORT_TAGS = (  all  => [ qw(

100