From mboxrd@z Thu Jan  1 00:00:00 1970
X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on polar.synack.me
X-Spam-Level: 
X-Spam-Status: No, score=0.4 required=5.0 tests=BAYES_00,INVALID_DATE,
	UNRESOLVED_TEMPLATE autolearn=no autolearn_force=no version=3.4.4
X-Google-Language: ENGLISH,ASCII-7-bit
X-Google-Thread: 103376,edaad852787c269c,start
X-Google-Attributes: gid103376,public
X-Google-ArrivalTime: 1994-10-14 11:08:14 PST
Path: 
 bga.com!news.sprintlink.net!howland.reston.ans.net!usenet.ins.cwru.edu!news.ysu.edu!psuvm!auvm!EUROCONTROL.DE!wel
Comments: Gated by NETNEWS@AUVM.AMERICAN.EDU
Newsgroups: comp.lang.ada
Message-ID: <9410141050.AA02186@eurocontrol.de>
Date: Fri, 14 Oct 1994 11:50:49 +0100
Sender: Ada programming language <INFO-ADA@NDSUVM1.BITNET>
From: Bob Wells #402 <wel@EUROCONTROL.DE>
Subject: Re: Easily-Read C++?
Comments: To: INFO-ADA%NDSUVM1.BITNET@vm.gmd.de
Date: 1994-10-14T11:50:49+01:00
List-Id: <comp.lang.ada>

Robert Dewar <dewar@CS.NYU.EDU> writes .....

> Subject: Re: Easily-Read C++?
>
> There are to my mind three justifications for comments:
>
> Saying WHY you are doing something, and WHY you did it that way
>
> Saying WHY you did NOT do something, and WHY you did NOT
>
> Describing WHAT the code does, but at a higher level of abstraction
> than the code itself.

G'day Robert,
I totally agree with the above justifications and would also add the
following two:

Describing assumptions about the format or structure of an external
interface, e.g. an incoming message.

-- STAMINA message originator format
-- ORIG/ROLE/HQ

Describing the corresponding meaning for values when they are
defined. For example.

-- The following corresponds to the field RBT in the STORE.QTID section of
-- the PEAQTID file when the TYP field contains a 1 and RBN /= 0.
--
type Rlb_Data is ( Sdd_Coordinates,
                   Plot_Identification,
                   Track_Identification,
                   Sdd_Test_Picture_Display,
                   Track_Id_Or_System_Coordinates,
                   System_Coordinates,
                   Ssr_Code );

Regards,
Bob W. (-: