No, the documentation is expecting you to go read some other documentation to answer a perfectly reasonable question, and doesn't even have the courtesy to tell you where that documentation is. Certainly most Perl programmers with any degree of experience can probably work it out, even if they haven't used that debugger feature before, but that logic applies to a lot of things that are, nonetheless, extensively documented—which I've always regarded as a feature of Perl's documentation, to be honest.


If God had meant us to fly, he would *never* have given us the railroads.
    --Michael Flanders

In reply to Re^2: My nomination for the worst sentence in Perl documentation ever by ChemBoy
in thread My nomination for the worst sentence in Perl documentation ever by adamsj

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.