Beefy Boxes and Bandwidth Generously Provided by pair Networks
go ahead... be a heretic

Re^2: Multi-line comments in perl code?

by cxw (Scribe)
on Apr 03, 2020 at 01:29 UTC ( #11114969=note: print w/replies, xml ) Need Help??

in reply to Re: Multi-line comments in perl code?
in thread Multi-line comments in perl code?

To clarify: as of writing, on Perl 5.28.1 and Perldoc v3.2801:
  • =for comment hides text from perl but not perldoc
  • =begin comment hides text from both perl and perldoc
For example, given as follows:
=head1 SECTION =for comment Comment! =cut =begin comment Comment! Number 2 =end comment =cut
  • perl produces empty output and no errors
  • perldoc produces:
    SECTION Comment!

    which is the text from the =for comment / =cut block.
Therefore, I personally use =begin comment / =end comment / =cut, even though it's a bit tedious.

Replies are listed 'Best First'.
Re^3: Multi-line comments in perl code?
by haukex (Archbishop) on Apr 03, 2020 at 06:53 UTC
    =for comment Comment! =cut
    ... produces:
    SECTION Comment!

    That is the correct behavior, your conclusion "=for comment hides text from perl but not perldoc" isn't correct. From perlpod (emphasis mine):

    The command "=for formatname text..." specifies that the remainder of just this paragraph (starting right after formatname) is in that special format.

    Remove the blank line after the =for and the "Comment!" is hidden. The =for still begins a section of POD that needs to be terminated by =cut, so Perl will ignore the entire example you posted.

Log In?

What's my password?
Create A New User
Domain Nodelet?
Node Status?
node history
Node Type: note [id://11114969]
and the web crawler heard nothing...

How do I use this? | Other CB clients
Other Users?
Others drinking their drinks and smoking their pipes about the Monastery: (3)
As of 2022-08-18 14:06 GMT
Find Nodes?
    Voting Booth?

    No recent polls found