comp.lang.ada
 help / color / mirror / Atom feed
From: "Steve Doiel" <nospam_steved@pacifier.com>
Subject: Re: Comments at the End of Lines
Date: 1999/07/03
Date: 1999-07-03T00:00:00+00:00	[thread overview]
Message-ID: <377e3757.0@news.pacifier.com> (raw)
In-Reply-To: 7lir0r$og1$1@usenet01.srv.cis.pitt.edu


John Duncan wrote in message <7lir0r$og1$1@usenet01.srv.cis.pitt.edu>...
>> Finally, not related to Ada, a C style guide I was asked to review had a
>rule
>> that said not to put comments at the end of lines.
>
>I'm not exactly sure, but if you consider the C example, comments on the
>same line tend to be used to "explain" a very mangled semantic structure.
As
>far as the meaning of each line is concerned, you shouldn't need comments
at
>the end of the line. Consider:
>
>Beta := Sqrt(X); -- Assign sqrt(x) to beta
>
You'll have a hard time persuading me that you need comments on separate
lines for the following code (declarations).

  pieceLength  : Float; -- inches
  pieceArea     : Float; -- square feet
  pieceVolume : Float; -- cubic feet

SteveD







  parent reply	other threads:[~1999-07-03  0:00 UTC|newest]

Thread overview: 10+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
1999-07-02  0:00 Comments at the End of Lines Roger Racine
1999-07-02  0:00 ` Martin C. Carlisle
1999-07-02  0:00 ` John Duncan
1999-07-02  0:00   ` Robert Dewar
1999-07-02  0:00   ` Robert Dewar
1999-07-03  0:00   ` Steve Doiel [this message]
1999-07-03  0:00     ` Larry Kilgallen
1999-07-03  0:00     ` John Duncan
1999-07-03  0:00       ` Steve Doiel
1999-07-03  0:00     ` Chad R. Meiners
replies disabled

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox