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=-1.3 required=5.0 tests=BAYES_00,INVALID_MSGID
	autolearn=no autolearn_force=no version=3.4.4
X-Google-Language: ENGLISH,ASCII-7-bit
X-Google-Thread: f891f,8eaea1d1465f843d
X-Google-Attributes: gidf891f,public
X-Google-Thread: 10261c,8eaea1d1465f843d
X-Google-Attributes: gid10261c,public
X-Google-Thread: 109fba,8eaea1d1465f843d
X-Google-Attributes: gid109fba,public
X-Google-Thread: 103376,8eaea1d1465f843d
X-Google-Attributes: gid103376,public
X-Google-Thread: 1014db,8eaea1d1465f843d
X-Google-Attributes: gid1014db,public
X-Google-Thread: 10c949,8eaea1d1465f843d
X-Google-Attributes: gid10c949,public
X-Google-Thread: 1094ba,8eaea1d1465f843d
X-Google-Attributes: gid1094ba,public
X-Google-Thread: 110e3b,8eaea1d1465f843d
X-Google-Attributes: gid110e3b,public
From: Hercules Gunter <hgunter@wantree.com.au>
Subject: Re: Comments
Date: 1996/11/11
Message-ID: <328828AA.4EF6@wantree.com.au>#1/1
X-Deja-AN: 196219099
references: <55sehb$kbl@columbia.acc.brad.ac.uk>
content-type: text/plain; charset=us-ascii
organization: Wantree Development
mime-version: 1.0
newsgroups: 
 comp.lang.ada,comp.lang.basic.misc,comp.lang.basic.visual.misc,comp.lang.c,comp.lang.c++,comp.lang.fortran,comp.lang.misc,comp.lang.pascal.misc,
x-mailer: Mozilla 3.0 (Win16; I)
Date: 1996-11-11T00:00:00+00:00
List-Id: <comp.lang.ada>


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.