Re: PDLx::Mask - search.cpan.org uses README.pod instead of lib/PDLx/Mask.pm
[email protected] (Diab Jerius)
| Newsgroups | perl.module-authors |
|---|---|
| Message-ID | <CADpyd5ALSf4y2cO4gCoHbhFdwskbvRofuEdUG_fvz+xsztbBiA@mail.gmail.com> |
Thanks. I'll move the README.pod somewhere innocuous. On Wed, Oct 26, 2016 at 6:52 PM, Dan Book <[email protected]> wrote: > On Wed, Oct 26, 2016 at 6:14 PM, Diab Jerius <[email protected]> > wrote: >> >> Howdy, >> >> The PDLx-Mask distribution has a README.pod file at the top level, as >> well as actual module documentation in lib/PDLx/Mask.pm. >> >> On the module's main page: >> >> http://search.cpan.org/~djerius/PDLx-Mask-0.01/ >> >> The PDLx::Mask link goes to README.pod, not to lib/PDLx/Mask.pm >> >> That's not quite what I expected, while this >> >> https://metacpan.org/pod/PDLx::Mask >> >> is. >> >> Should I not be uploading the README.pod file? I use that to >> generate README and README.md. >> >> Thanks, >> >> Diab > > > You should not upload any .pod files in the top level of the distribution, > as they will get indexed and installed for historical reasons. (Metacpan > sees the name in that document as PDLx::Mask, so it does not override the > indexed PDLx::Mask documentation in their index. Search.cpan.org clearly has > different logic we are not privy to.) README.md and README are fine. > > -Dan