Re^2: my pod isn't showing up on search.cpan.org but shows on metacpan (module name, manifest, preview)

[gideondsouza]

Thanks very much for your reply. I had a slight inkling that was it but didn't really think it through.It's a little cryptic but, oh well, off I goto change my module.

Is this fact documented somewhere? I check my pod on the command line with perldoc.

[Anonymous Monk]

s/cryptic/convention/

It has been a convention for more than a decade -- probably documented somewhere (i don't know where), maybe https://pause.perl.org/pause/query?ACTION=pause_namingmodules, maybe http://www.cpan.org/modules/04pause.html, maybe perlnewmod, maybe (UTSL) http://github.com/andk/pause, maybe perlpodstyle, perlmodstyle, perlutil, perlglossary, I really can't be bothered to track it down

[Anonymous Monk]

This convention could be inherited from manpages

Conventional section names include NAME, SYNOPSIS, CONFIGURATION, DESCRIPTION, OPTIONS, EXIT STATUS, RETURN VALUE, ERRORS, ENVIRONMENT, FILES, VERSIONS, CONFORMING TO, NOTES, BUGS, EXAMPLE, AUTHORS, and SEE ALSO.