There are several solutions for multiline comments like turning a section of code into a string with q or HEREDOC, POD, or source filters if (0). The first category will trigger a warning in most cases (You could always start all your comments with 'igor' or 'dilbert' though :P). The second puts unused code in what should be useful documentation. The third uses source filters, which are impopular among several perl users (mostly because can cause confusing errors, since the code compiled by perl is not the one in the text file). The if (0) solution doesn't work on everything (if there's a BEGIN block somewhere in the commented code, it will still be executed), and won't compile if there's a syntax error in the disabled code.

To me the best solution still is source filters, but since most editors allow you to easily comment several lines of code at once, I just go for that (ctrl+Q on selected code on my version of notepad++, or other shortcuts depending on exactly what you want to do).

Edit: and for private methods, well LanX actually gave you the answer.

In reply to Re: Comment blocks & private methods by Eily
in thread Comment blocks & private methods by misterperl

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.