* Damian Conway ([EMAIL PROTECTED]) [060314 23:03]:
> Larry wrote:
>
> >On Tue, Mar 14, 2006 at 06:36:22PM +0100, Ruud H.G. van Tol wrote:
> >: Or POD-ish.
> >
> >Or POD-ish is what A2 proposes. I still like
> >
> > =begin FOO
> > ...
> > =end FOO
>
> And I'm in the midst of writing S26 (Documentation),
> wherein I propose a standard:
>
> =begin comment
> ...
> =end comment
>
> form.
> (And, yes, they nest correctly).
Looking very much forward to it... as you know.
But don't you think that the term "comment" is too general? The comment
text has a purpose, for instance
- comment to explain code
- comment for future implementation ideas
- references to design documents
- etc etc
The "comment" keyword is telling us nothing more than
=begin skip_this
...
=end
F.i:
=explain code
or
=begin explain code
--
MarkOv
------------------------------------------------------------------------
Mark Overmeer MSc MARKOV Solutions
[EMAIL PROTECTED] [EMAIL PROTECTED]
http://Mark.Overmeer.net http://solutions.overmeer.net
