Beefy Boxes and Bandwidth Generously Provided by pair Networks
Pathologically Eclectic Rubbish Lister
 
PerlMonks  

comment on

( [id://3333]=superdoc: print w/replies, xml ) Need Help??
> Perl does have good documentation provided by O'Reilly in the form the
> llama and camel books.
Perhaps you've noticed, perhaps not. The Camel book is essentially a printed version of the perlfunc perldoc/manpage. Which means in particular that the exec function is just as obscurely documented for £26.80 as for the free machine readable version.

As to the state of the documentation, you should be aware that the evolution of perl over the past two or three years (since 5.003) has been in great leaps and bounds, with the number of modules in the CPAN more or less keeping pace. The amount of documentation is awe inspiring, if some of the individual examples of it perhaps are not.

Now that 5.6 is out, give the documentation a year or so to catch up.

In the meantime, sites like this one can fill the gap, at least in terms of pointing out which of the hundreds of "things" to read might be helpful apropos of a particular problem.


In reply to RE: The sad state of Perl documentation by dmmiller2k
in thread The sad state of Perl documentation by SuperCruncher

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



  • Are you posting in the right place? Check out Where do I post X? to know for sure.
  • Posts may use any of the Perl Monks Approved HTML tags. Currently these include the following:
    <code> <a> <b> <big> <blockquote> <br /> <dd> <dl> <dt> <em> <font> <h1> <h2> <h3> <h4> <h5> <h6> <hr /> <i> <li> <nbsp> <ol> <p> <small> <strike> <strong> <sub> <sup> <table> <td> <th> <tr> <tt> <u> <ul>
  • Snippets of code should be wrapped in <code> tags not <pre> tags. In fact, <pre> tags should generally be avoided. If they must be used, extreme care should be taken to ensure that their contents do not have long lines (<70 chars), in order to prevent horizontal scrolling (and possible janitor intervention).
  • Want more info? How to link or How to display code and escape characters are good places to start.
Log In?
Username:
Password:

What's my password?
Create A New User
Domain Nodelet?
Chatterbox?
and the web crawler heard nothing...

How do I use this?Last hourOther CB clients
Other Users?
Others examining the Monastery: (8)
As of 2024-04-18 12:56 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?

    No recent polls found