=head1 NAME perlnewmod - preparing a new module for distribution
=head1 DESCRIPTION This document gives you some suggestions
about how to go about writing Perl modules, preparing them for
distribution, and making them available via CPAN. One of the
things that makes Perl really powerful is the fact that Perl
hackers tend to want to share the solutions to problems they've
faced, so you and I don't have to battle with the same problem
again. The main way they do this is by abstracting the solution
into a Perl module. If you don't know what one of these is, the
rest of this document isn't going to be much use to you. You're
also missing out on an awful lot of useful code; consider having
a look at L, L and L before coming back here. When you've found
that there isn't a module available for what you're trying to
do, and you've had to write the code yourself, consider
packaging up the solution into a module and uploading it to CPAN
so that others can benefit. =head2 Warning We're going to
primarily concentrate on