Re: List container strawman 1.2

[Stephen Leake <stephen.a.leake.1@gsfc.nasa.gov>]

Ted Dennison<dennison@telepath.com> writes:

> In article <3BF05337.75BE0A18@san.rr.com>, Darren New says...
> >
> >Darren New wrote:
> >    function "&" (Left, Right : Element) return List;
> >        -- O(1)
> 
> I much prefer pre-comments to post-comments. The reason is that you read them
> before you get to the source, rather than after you have already tried to read
> the source and are perhaps already confused and/or misled. Forewarned is
> forearmed. :-)

Well, I prefer to read the Ada source first, to get as much
information as possible, then read the comments. If you put the
comments first, and they are at all long, you start having to repeat
parts of the Ada code (like the function and parameter names) at the
top of the comment; a very bad idea.

-- 
-- Stephe