[Doc-SIG] Re: POD

klm@digicool.com klm@digicool.com
Thu, 29 Mar 2001 17:16:34 -0500 (EST)

I wrote:

> in it???  Maybe such stuff looks clean in the midst of perl code, but
> such docstrings will be more cluttered and less readable than the [python]
> code, itself!  Why the heck would you want to do that?  Have mercy on
> the programmer who wants to read docstrings.

I guess, if there's multiple proposals, we can have a kind of bake-off
where we get to look at examples of the different formats.  At least
there the relative lack of clutter in ST will be clear.  That won't
settle fears of being hemmed in or tripped up by the rules, that would
have to be addressed with acceptable and formal rules, clean
implementation, etc.  But from what i've seen of the alternatives, i'd
be really sad to have to endure docstrings with noisy garbage in them
in order to have some structure expressed.  Yuck.