note
dimar
<p>
It's time for @#$! multiline comments in perl!
<h2>Yeah yeah, I know ...</h2>
<ul>
<li> use 'here docs' (poor option)
<li> use 'POD' (interferes with docs and no indenting)
<li> use 'ACME::Comment' (requires module install rights)
<li> use the 'q' operator (unsuitable for serious use)
</ul>
</p>
<code>
q`<!-- ---------------------------
<region-function_docs>
main:
- name : DoFoo
desc : do some foo
usage: DoFoo($optional_greeting);
</region-function_docs>
--------------------------- -->`if(000);
sub DoFoo{
my $optional_greeting = shift || 'Hello World';
print "$optional_greeting\n";
print "we are now doing foo\n";
print "\n";
}###end_sub
</code>
<p>
So just write your code like that and problem (solved?).
</p>
<b>Update:</b> this workaround option parses free of warnings and errors, but is unsuitable for serious use in perl.
1695
1695