From: Hercules Gunter <hgunter@wantree.com.au>
Subject: Re: Comments
Date: 1996/11/11
Date: 1996-11-11T00:00:00+00:00 [thread overview]
Message-ID: <328828AA.4EF6@wantree.com.au> (raw)
In-Reply-To: 55sehb$kbl@columbia.acc.brad.ac.uk
re: automatic commenting of Ada programs
The point of comments is to explain the non-obvious bits of the code.
It's quality that counts, not quantity. Anything you can generate
automatically would have to be fairly obvious and of no use to the
person coming later who needs to understand the code. This is a job for
the human who write the code, or the poor maintenance programmer who had
to figure it out later.
next prev parent reply other threads:[~1996-11-11 0:00 UTC|newest]
Thread overview: 13+ messages / expand[flat|nested] mbox.gz Atom feed top
1996-11-07 0:00 Comments N.A.Smith
1996-11-11 0:00 ` Hercules Gunter [this message]
1996-11-13 0:00 ` Comments ennals
1996-11-14 0:00 ` Comments johnherro
1996-11-14 0:00 ` Comments Dirk Dickmanns
1996-11-18 0:00 ` Comments Richard A. O'Keefe
-- strict thread matches above, loose matches on Subject: below --
1997-03-12 0:00 Comments Beamish
[not found] <7ttb4a$8mq$1@nnrp1.deja.com>
1999-10-12 0:00 ` Self-referential types Matthew Heaney
1999-10-13 0:00 ` Robert I. Eachus
1999-10-13 0:00 ` Brian Rogoff
1999-10-15 0:00 ` Robert I. Eachus
[not found] ` <slrn80fl9f.68j.aidan@skinner.demon.co.uk>
1999-10-19 0:00 ` Wes Groleau
1999-10-21 0:00 ` Robert Dewar
1999-10-21 0:00 ` Comments (was: Self-referential types) Wes Groleau
1999-10-21 0:00 ` Ehud Lamm
1999-10-23 0:00 ` Robert Dewar
1999-10-23 0:00 ` Ehud Lamm
1999-10-23 0:00 ` Comments Georg Bauhaus
1999-10-24 0:00 ` Comments Ehud Lamm
1999-10-26 0:00 ` Comments Robert I. Eachus
1999-10-28 0:00 ` Comments Jerry van Dijk
1999-10-28 0:00 ` Comments Ted Dennison
1999-10-25 0:00 Comments Wilhelm Spickermann
replies disabled
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox