1. correctness of the perldoc asside, there are two very differnet use cases here. In the first case, you want to disable the code and keep it from ever running, but it will still be parsed and validated for syntactic (and semantic) correctness. This can be very advantagous when you want to temporarily disable some code, but you don't want anyone to move, remove, or refactor variables or functions that it calls. In the second case, by making the lines perldoc, their content is irrelevant, and you're free to do whatever you want.
  2. Frankly, if you are using a decent text editor or IDE, it should be trivial to comment out a large number of lines with a simple macro, and it should be jsut as simple to uncomment then later. And i find it a lot easier to spot at a glance when a large chunk of code is commented out then to tell when a large chunk of code is "poded out". Even when I'm working with java, which supports both a prefix comment marker, and a delimiting comment marker, i always use the prefix comments to comment out a large chunk of code. that long column of comment characters really jumps out at you.

In reply to Re: how about cool uses for perlDOC? by hossman
in thread how about cool uses for perlDOC? by geektron

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.