Online documentation? Of course, `perldoc' is the canonical answer. I believe however that Tom Christianson is perldoc's author and has himself referred to perldoc as "this noisome program" (for a sense of what 'noisome' means please read the entirety of The Lord of the Rings by J.R.R. Tolkien ;-). Just mentioned as background data.

It doesn't hurt a newbie to *nix-style programming to learn to use man pages, in general, though. I happen to like manpages. GNU feel that the `info' system is superior but good 'ol `man' still does the trick in a pinch. On some systems that I have had, `man' worked considerably better than `perldoc' did.

A non-ActiveState Perl-Win32 installation might install the actual Perl man pages for you. One such would be the Perl built with Cygwin. So in fact on most *nix boxen and some Winboxen as well, you could type 'man perlfunc' and get the man-ized Perl functions documentation presented by the type formatting system backend behind the `man' command. That backend is a complex many-headed creature referred to variously as 'nroff' and 'troff' and also may involve a sort of wrapper program named 'groff' which is GNU software. So, just FYI, it is actually possible to read manpages on Windows -- not just the Perl manpages (which may well not be there unless you deliberately do something to generate some, 'cause ActivePerl won't), but any manpages at all: a Win32 port of groff is available as a precompiled binary (or download source yourself and build it using free tools like the mingw project provides): find it here at the SourceForge-hosted "Gnu-Win32" project site. With groff and some patience and pluck one can get a manreader working even without an available port of 'man'. I wrote one and it works pretty nicely (it is a shell script).

Intrepid a.k.a. perlspinr a.k.a. Soren Andersen

In reply to Re: Perl Man Pages by Intrepid
in thread Perl Man Pages by Clem

Title:
Use:  <p> text here (a paragraph) </p>
and:  <code> code here </code>
to format your post, it's "PerlMonks-approved HTML":


  • Posts are HTML formatted. Put <p> </p> tags around your paragraphs. Put <code> </code> tags around your code and data!
  • Titles consisting of a single word are discouraged, and in most cases are disallowed outright.
  • Read Where should I post X? if you're not absolutely sure you're posting in the right place.
  • Please read these before you post! —
  • Posts may use any of the Perl Monks Approved HTML tags:
    a, abbr, b, big, blockquote, br, caption, center, col, colgroup, dd, del, details, div, dl, dt, em, font, h1, h2, h3, h4, h5, h6, hr, i, ins, li, ol, p, pre, readmore, small, span, spoiler, strike, strong, sub, summary, sup, table, tbody, td, tfoot, th, thead, tr, tt, u, ul, wbr
  • You may need to use entities for some characters, as follows. (Exception: Within code tags, you can put the characters literally.)
            For:     Use:
    & &amp;
    < &lt;
    > &gt;
    [ &#91;
    ] &#93;
  • Link using PerlMonks shortcuts! What shortcuts can I use for linking?
  • See Writeup Formatting Tips and other pages linked from there for more info.