in reply to PAUSE upload

You could, like, try downloading a Perl module from CPAN - and poke around its files.

Personally I use Module::Install. You can see what it looks like here: Event::Lite Download Link. The docs for Module::Install are long and unless I missed something don't really have a "START HERE DUMMY" (which I sure could have used) - but it works basically like this:

Make Your Folder

  1. Say your module is "My::Module::(Something)" - make a folder named "My-Module"
  2. In there, make a folder named "My-Modulelib/My/Module" and put all your *.pm files in "My-Module/lib/My/Module"
  3. Make a folder named "My-Module/inc" and copy all the files from the "inc" folder in the link above.
  4. Make "My-Module/Makefile.PL" - you could copy-n-paste the one from the link above and just substitute "My-Module" for "Event-Lite" and "lib/My/Module.pm" for "lib/Event/Lite.pm" and so on.
  5. List the modules your module requires for testing and for installation.
  6. Make some unit tests (*.t files) and put them in a folder named "My-Module/t/"
  7. Add a "My-Module/Changes" text file (like every other Perl module has) that describes what happened in each release.
  8. Add some POD documentation to your *.pm files wherever appropriate.

When you're ready to upload to CPAN

  1. cd My-Module
  2. perl Makefile.PL
  3. If there were problems - then fix them before continuing.
  4. make
  5. make manifest -- (lots of filenames that look familiar should scroll by)
  6. make disttest -- (this will pretend to install your module without really installing it).
  7. make dist -- this will make the *.tar.gz file for you.
  8. Go to The PAUSE Website and login.
  9. Click "Upload a file to CPAN" on the left.
  10. Upload your file.
  11. A few hours later it will appear on http://search.cpan.org/
  12. ??????
  13. PROFIT!!!!