Re^2: 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 foo.pl as follows:

=head1 SECTION

=for comment

Comment!

=cut

=begin comment

Comment! Number 2

=end comment

=cut
[download]

perl foo.pl produces empty output and no errors
perldoc foo.pl produces:
```
SECTION
    Comment!
[download]
```
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.

Comment on Re^2: Multi-line comments in perl code? Select or Download Code

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` [download] ... produces: `SECTION Comment!` [download] 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.	[reply] [d/l] [select]

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
[download]
... produces:
SECTION Comment!
[download]

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.

[reply]
[d/l]
[select]