Submitting Your Module to CPAN

Your goal in naming your module is to provide potential users with a clear 

picture of what your module does even before they look at your documentation. 

This is often a difficult task, but it is so critical to your module's success that you 

should spend the time to do it right.

Be aware that some module namespaces are administrated by a particular person 

or group (Tk::, Apache::, and DBI::, among others). This information is usually con 

tained in the documentation for the  root  module for example, the DBI module 

contains contact information regarding the DBI:: and DBIx:: namespaces. Even 

when the author of a module hasn't explicitly laid claim to the module namespace, 

you should contact him or her before uploading. For example, it would be polite to 

contact that author of CGI::Application before releasing CGI::Application::BBS.

Requesting a CPAN Author ID

After shopping around your RFC, the next step is to request a CPAN Author ID. To 

do this, send an e mail to modules@perl.org containing the following information:

  Your  name

  Your e mail address

  Your home page (optional)

  Your preferred Author ID (4 to 9 characters, uppercase letters only, one 

dash allowed)

  A short description of what you plan to contribute to CPAN

The description of your contribution doesn't need to be more than a single 

sentence per module. Later, when you submit a namespace registration request, 

you'll have a chance to fully describe your work.

When one of the modules@perl.org maintainers registers you, you'll receive an 

e mail explaining how to activate your PAUSE account. Usually registration happens 

in under a week; if you're waiting longer than that, it's occasionally necessary to 

send a reminder e mail. However, remember that CPAN is run by volunteers 

keep it friendly!

13

131

1