ParsonGeorge has asked for the wisdom of the Perl Monks concerning the following question:
I'm new to Perl and am trying to figure out how to use POD.
First, some important "stuff": OS: Windows 7 on my desktop and Ubuntu 1204 on my laptop (I use both somewhat interchangeably). Perl: Strawberry 5.18 on Windows, 5.14 on Linux. IDE: Padre and Eclipse/Epic (both loaded on each platform, and I alternate between them).
I've created just a tiny POD sample:
#!/usr/bin/perl print "Hello, World!\n"; =head1 NAME My::Module - An example module =cut
When I run the program, "Hello, World!" prints properly; the POD stuff is ignored (as I expect). However, how can I view the documentation?
I've tried running perldoc in a terminal with the name of the script as an argument: perldoc hello.pl -- but that doesn't seem to work.
I created a separate .POD file with some documentation and this did work: perldoc hello.pod. However, is there some way to view the documentation that's embedded in a script? Ideally, I'd like to embed the POD documentation at the bottom of a script and then click something or enter something to view that documentation from within either IDE.
Thanks, in advance, for any help you can offer.
|
---|
Replies are listed 'Best First'. | |
---|---|
Re: How To View POD Embedded in a Perl Script?
by LanX (Saint) on Apr 04, 2014 at 01:09 UTC | |
by ParsonGeorge (Initiate) on Apr 04, 2014 at 13:26 UTC | |
by LanX (Saint) on Apr 04, 2014 at 13:40 UTC | |
Re: How To View POD Embedded in a Perl Script?
by Anonymous Monk on Apr 04, 2014 at 01:47 UTC | |
by ParsonGeorge (Initiate) on Apr 04, 2014 at 13:28 UTC | |
Re: How To View POD Embedded in a Perl Script?
by Laurent_R (Canon) on Apr 04, 2014 at 06:16 UTC | |
Re: How To View POD Embedded in a Perl Script?
by Discipulus (Canon) on Apr 04, 2014 at 09:48 UTC | |
by ParsonGeorge (Initiate) on Apr 04, 2014 at 13:31 UTC | |
Re: How To View POD Embedded in a Perl Script?
by ParsonGeorge (Initiate) on Apr 04, 2014 at 13:42 UTC |