I am sorry I cannot respond to this in full. In 24 hours I need to be on the other side of the continent giving a talk and I don't have room for much else.

But I was not trying to slam this site. No matter what this site does, it will be wrong for someone. I have seen people here using 5.004, 5.005, and 5.6. These are all different. You simply will not get a single reference, be it a book or a website, to conveniently document all of these in any straightforward way for people to use. Whether or not this documentation is updated, it is a mistake to encourage people to rely on it.

Instead what I would love to see is to have every page taken from Perl's documentation have up top a disclaimer like this:

This documentation may be for a different version of Perl than what you have.
For more accurate documentation please type perldoc (whatever)
Letting people know the problem and encouraging them to get the answer from the right place would IMNSHO do far more good than telling them to rely on this site and trying to be all things to all people.

BTW you should see Tom Christiansen rant on this topic some time...

In reply to RE (tilly) 9: Should I use $ and $# ? by tilly
in thread Should I use $ and $# ? by Guildenstern

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.