putting POD files on CPAN

[Darren Duncan]

On Mon, 10 Feb 2003, Peter Scott wrote:
> Might need to ask the CPAN folks about that.  Documentation.pod doesn't
> sound very standard practice to me.  Perhaps it needs to be in lib/
> instead of the root.  Or a pod/ directory, following the Perl core
> pattern.  If you're going to make a separate .pod file wouldn't
> Rosetta.pod be a better name?

As a follow-up, I have gotten a reply from Graham Barr, who was the
recipient of the Feedback page on CPAN Search.  His first reply said that
my Rosetta.pm and Documentation.pod both had the same Name, which caused
only one to be indexed, and he asked why I was doing what I was doing,
which looked non-standard.  After I replied to that, he gave me an answer
like what I was looking for.  For your reference, a copy of it is below.
It looked like your own suggestion, Peter, about filing under lib/.  Have
a good day. -- Darren Duncan

---------------------------------------------

From: Graham Barr <search-rt at cpan.org>

I would suggest putting it in a file under lib/Rosetta, say for example
lib/Rosetta/Framework.pod but make sutr that the line in the NAME section
starts with Rosetta::Framework so the search site knows this is not
the pod for the Rosetta module.

You find other distributions do this for thier faq (eg Rosetta::FAQ in
lib/Rosetta/FAQ.pod)

Graham.