I feel a bit foolish asking this, but here goes...

Although I've written many modules over the years, I've never written one for CPAN. Now I'm trying to and finding that the logistics of it are a bit confusing.

As recommended, I started with h2xs. It created a skeleton directory tree like this: 

[perrin@charlotte oscon]$ h2xs -AX -n Foo::Bar       
Writing Foo/Bar/Bar.pm
Writing Foo/Bar/Makefile.PL
Writing Foo/Bar/test.pl
Writing Foo/Bar/Changes
Writing Foo/Bar/MANIFEST

[download]
Well, this is all good, but now I can't actually load that stub without installing the module, i.e. if I say use Foo::Bar, perl will not find Bar.pm in that structure. I could install the module and edit it, but then how do I bundle it back up for distribution? Do I have to manually copy everything back into place?

Apologies if this is all covered in the MakeMaker docs somewhere that I missed. If someone can give me a good pointer, I'll be happy to RTFM.

For the curious, the module (no, it's not really called Foo::Bar), is part of my presentation for this year's Perl Conference.

In reply to MakeMaker, h2xs, and writing CPAN modules by perrin

Title:
Use:  <p> text here (a paragraph) </p>
and:  <code> code here </code>
to format your post, it's "PerlMonks-approved HTML":


  • Posts are HTML formatted. Put <p> </p> tags around your paragraphs. Put <code> </code> tags around your code and data!
  • Titles consisting of a single word are discouraged, and in most cases are disallowed outright.
  • Read Where should I post X? if you're not absolutely sure you're posting in the right place.
  • Please read these before you post! —
  • Posts may use any of the Perl Monks Approved HTML tags:
    a, abbr, b, big, blockquote, br, caption, center, col, colgroup, dd, del, details, div, dl, dt, em, font, h1, h2, h3, h4, h5, h6, hr, i, ins, li, ol, p, pre, readmore, small, span, spoiler, strike, strong, sub, summary, sup, table, tbody, td, tfoot, th, thead, tr, tt, u, ul, wbr
  • You may need to use entities for some characters, as follows. (Exception: Within code tags, you can put the characters literally.)
            For:     Use:
    & &amp;
    < &lt;
    > &gt;
    [ &#91;
    ] &#93;
  • Link using PerlMonks shortcuts! What shortcuts can I use for linking?
  • See Writeup Formatting Tips and other pages linked from there for more info.