Beefy Boxes and Bandwidth Generously Provided by pair Networks
Do you know where your variables are?
 
PerlMonks  

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

by Anonymous Monk
on Feb 03, 2013 at 05:14 UTC ( #1016774=note: print w/ replies, xml ) Need Help??


in reply to my pod isn't showing up on search.cpan.org but shows on metacpan

Generally, the NAME section is expected to match the package name, which is supposed to match the the file name to qualify as a module name

But you can view your file via manifest (or keyboard) ;)

http://search.cpan.org/~gideon/Net-StackExchange2-0.01_2/MANIFEST -> http://search.cpan.org/~gideon/Net-StackExchange2-0.01_2/lib/Net/StackExchange2/V2.pm

Though I've not used it, http://search.cpan.org/pod2html PREVIEW might help in the future,

Example of this naming convention

$ module-starter --module Shabba --email email --author author --verbo +se Created Shabba Created Shabba\lib Created Shabba\lib\Shabba.pm Created Shabba\t Created Shabba\t\pod-coverage.t Created Shabba\t\pod.t Created Shabba\t\manifest.t Created Shabba\t\boilerplate.t Created Shabba\t\00-load.t Created Shabba\ignore.txt Created Shabba\Makefile.PL Created Shabba\Changes Created Shabba\README Added to MANIFEST: Changes Added to MANIFEST: ignore.txt Added to MANIFEST: lib/Shabba.pm Added to MANIFEST: Makefile.PL Added to MANIFEST: MANIFEST Added to MANIFEST: README Added to MANIFEST: t/00-load.t Added to MANIFEST: t/boilerplate.t Added to MANIFEST: t/manifest.t Added to MANIFEST: t/pod-coverage.t Added to MANIFEST: t/pod.t Created Shabba\MANIFEST Created starter directories and files $ perldoc Shabba\lib\Shabba.pm |head -n2 NAME Shabba - The great new Shabba! $ perldoc -u Shabba\lib\Shabba.pm |head -n3 =head1 NAME Shabba - The great new Shabba!


Comment on Re: my pod isn't showing up on search.cpan.org but shows on metacpan (module name, manifest, preview)
Download Code
Re^2: my pod isn't showing up on search.cpan.org but shows on metacpan (module name, manifest, preview)
by gideondsouza (Pilgrim) on Feb 03, 2013 at 05:40 UTC

    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.

      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.

Log In?
Username:
Password:

What's my password?
Create A New User
Node Status?
node history
Node Type: note [id://1016774]
help
Chatterbox?
and the web crawler heard nothing...

How do I use this? | Other CB clients
Other Users?
Others studying the Monastery: (13)
As of 2014-08-28 13:39 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?

    The best computer themed movie is:











    Results (261 votes), past polls