How to submit a script to CPAN
- Get a PAUSE ID;
this is required to upload files to CPAN.
- Create your script:
- It must be a single file, not compressed or archived. This
constraint will be relaxed in the future.
- Insert the appropriate POD sections, as outlined below.
(If you don't know what POD is, consult the `perlpod'
manpage). There is one mandatory section, and several
- The mandatory POD section is `SCRIPT CATEGORIES'. The
existence of this section informs PAUSE that this is a
script. The contents of this section indicate where the
script should be presented in the
categorized hierarchy; currently, you may specify up to
three categories for your script.
- The optional POD section `PREREQUISITES' contains a list
of modules which this script requires in order to
- The optional POD section `COREQUISITES' contains a list of
modules which this script would benefit from having
available, but which are not required.
- The optional POD section `OSNAMES' contains a list of
operating systems (as given in Perl's $^O variable) under
which this script will run.
- The contents of the optional POD section `README' will be
automatically extracted and displayed.
- You may wish to check your script's format against
- Upload your script to PAUSE.
- New script categories are not automatically created. If you
stipulate a SCRIPT CATEGORIES entry that does not exist, it will
be silently ignored. New categories are created via discussion on
the scripts mailing list.
Please join the list before posting to it, by sending an empty
Contents of POD sections
The data in the POD sections, outlined above, must be presented in a
machine-readable format. There are two ways to present the data:
The example script
contains COREQUISITES, OSNAMES, and SCRIPT CATEGORIES sections in the
first format, and a PREREQUISITES section in the second format.
- Unadorned, one item per line.
- Embedded in descriptive text, with the data appearing between
C< and >.
Improving the process
The scripts repository is still being refined. Please report and problems
or suggestions to
Last modified: Fri May 10 01:32:56 CEST 2002