develooper Front page | perl.perl6.language.mlc | Postings from August 2000

Fw: Recording what we decided *not* to do, and why

Thread Next
Michael Mathews
August 4, 2000 06:45
Fw: Recording what we decided *not* to do, and why
Message ID:
[forwarded from the general language list]

----- Original Message -----
From: "Glenn Linderman" <>
To: "Larry Wall" <>
Cc: "John Porter" <>; <>
Sent: Thursday, August 03, 2000 9:44 PM
Subject: Re: Recording what we decided *not* to do, and why

> Larry Wall wrote:
> > A less obvious strategy is to try to see where various marginal
> > features could be subsumed under some more powerful feature.
> In general, this is a good^Wgreat concept to avoid multitudinous small
> > To some extent,
> I'm glad you qualified this...
> > you see this with the ability to use pod for multiline
> > comments.
> There's a certain relationship between documentation via pod and
> via comments.   If pod and comments could be totally unified, this might
be a
> good idea.  But they already have separate syntaxes: so unifying them
> require changes to one or both.  Without total unification and uniform
> for both, I think it better to leave comments and pod as separate
> documentation for publication is often at a different level, and better
> mixed with internals documentation anyway: the different syntaxes for
code, pod,
> and comments helps the author keep them visually separate.
> > For embedded comments, we might rather see some kind of
> > macro facility that could turn qc// or any other quoted form into a
> > list of zero or more tokens.
> There's a number of us that have been arguing about that topic.  We wish
> -mlc list would become responsive.  While a function style or quoted form
> comment might seem clever, and even Perlish due to its syntax, it doesn't
> the author of the code/comments readily distinguish them.  What good are
> comments if you can't find them when you need them?
> > Larry
> --
> Glenn
> =====
> There  are two kinds of people, those
> who finish  what they start,  and  so
> on...                 -- Robert Byrne
> _______________________________________________
> Why pay for something you could get for free?
> NetZero provides FREE Internet Access and Email

Thread Next Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at | Group listing | About