> =head1 EXAMPLES
>
> # multiline comments
>
> sub comment
> {
> return '';
> }
>
> use immediate 'comment';
>
> sub foo
> {
> # ...
> comment {
> this is a multiline comment;
> the call to comment is executed at parse time
> and returns an empty string that replaces
> the whole call in the parse stream };
> }
I have updated the Multiline Comment RFC with responces and conclusions
based on the feedback that has been submitted so far. If you are presenting
this example as an alternative/addition to the suggestions made there (so
far) I would strongly encourage you to read what has already been discussed,
particularly the problems with using a function or subroutine-like
mechanisms for commenting arbitrary blocks of code.
--Michael