Re^2: Answer: Better ways to make multi-line comments in Perl?

~~Actually, either works.~~ Didn't test correctly; used =begin comment ... =cut (which works) rather than =begin comment ... =end comment as AM proposed in Re: Answer: Better ways to make multi-line comments in Perl?. Fingers in gear; brain lagging behind.

I found the =begin/=end format in http://perldoc.perl.org/perlpodspec.html#Pod-Commands\perlpodspec for 5.22 only under the heading "About Data Paragraphs and "=begin/=end" Regions" but ""=begin comment ... =end comment" does not work in AS 5.18.

Granted, I'm mixing apples and ostrich eggs, above, but perlpod for 5.22 also appears (unless I'm misreading it) to suggest that =begin formatname/=end formatname and =for formatname... styles are for specialized cases only (see formatname, and not for run-of-the-mill comments.

Spirit of the Monastery

Comment on Re^2: Answer: Better ways to make multi-line comments in Perl? Select or Download Code

Replies are listed 'Best First'.
Re^3: Answer: Better ways to make multi-line comments in Perl? (=end =cut) by Anonymous Monk on Aug 23, 2015 at 22:30 UTC
I see what you mean, =end doesn't signal to perl "pod over, perl code starts again", =cut does that, so it would have to be =begin comment ... =end comment\n=cut Using `=for multiblock comment` has the unwanted side-effect of showing up if you use perldoc/pod2html... =pod/=cut has the same side-effect but that version is labeled quick/dirty If the intention is for #comments that aren't part of the documentation, =for comment multiline doesn't quite work for that purpose	[reply] [d/l]

Replies are listed 'Best First'.

Re^3: Answer: Better ways to make multi-line comments in Perl? (=end =cut)
by Anonymous Monk on Aug 23, 2015 at 22:30 UTC

I see what you mean, =end doesn't signal to perl "pod over, perl code starts again", =cut does that, so it would have to be =begin comment ... =end comment\n=cut

Using =for multiblock comment has the unwanted side-effect of showing up if you use perldoc/pod2html...

=pod/=cut has the same side-effect but that version is labeled quick/dirty

If the intention is for #comments that aren't part of the documentation, =for comment multiline doesn't quite work for that purpose

[reply]
[d/l]