Beefy Boxes and Bandwidth Generously Provided by pair Networks
P is for Practical
 
PerlMonks  

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

by dimar (Curate)
on Jul 14, 2006 at 16:24 UTC ( [id://561256]=note: print w/replies, xml ) Need Help??


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

Among other things, POD does not support indentation
Sure it does -- in a Pod format block.

Perhaps, but that particular definition of "indentation" is ... shall we say, a lot more 'loose' than the originally intended definition, which can be illustrated as follows:

=for comment This comment can be indented as much as I want and even more than I want =cut for(0 .. 4){ for(0 .. 3){ for (0 .. 2){ =for comment However, even though "indentation" is supported here, we still have those dangling POD delimiters way back over there. <- <- <- <- Attempting to line them up with the rest of the code produces an error. This is not good because it breaks 'code-folding' in the text editor. It also looks just plain ugly. =cut print "$_\n"; }; }; }; __END__

Moreover, one has to consider whether the POD in this illustration is even well-formed to begin with. Should this be a format block? Will begin/end work? Is 'for comment' sufficient? Will this mess up the POD documentation? *Way* too much hassle when all you wanted was a *comment*.

Replies are listed 'Best First'.
Re^4: Multi-line comments in perl code?
by xdg (Monsignor) on Jul 14, 2006 at 18:47 UTC

    Now I understand what you meant. "Supports" is a vague term. I would have said instead that Pod commands can't be indented, which breaks up the indentation of code around it.

    Personally, I use vim and let it handle my comments for me.

    -xdg

    Code written by xdg and posted on PerlMonks is public domain. It is provided as is with no warranties, express or implied, of any kind. Posted code may not have been tested. Use of posted code is at your own risk.

Log In?
Username:
Password:

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

How do I use this?Last hourOther CB clients
Other Users?
Others making s'mores by the fire in the courtyard of the Monastery: (2)
As of 2024-03-19 05:20 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?

    No recent polls found