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: 103376,e94a7e4f6f888766
X-Google-Attributes: gid103376,public
From: Richard D Riehle <laoXhai@ix.netcom.com>
Subject: Re: Self-referential types
Date: 1999/10/22
Message-ID: <7uq8vo$9gs$1@nntp6.atl.mindspring.net>#1/1
X-Deja-AN: 539345095
References: <7ttb4a$8mq$1@nnrp1.deja.com> <s04ql7cqh1s45@corp.supernews.com>
 <3802f2db_2@news1.prserv.net> <3803B5E3.F96A6DD4@mitre.org>
 <3803c8bc_2@news1.prserv.net> <3804E7E0.6A0265FB@mitre.org>
 <Pine.BSF.4.10.9910132009020.18305-100000@shell5.ba.best.com>
 <38077EB3.E6911567@mitre.org> <slrn80fl9f.68j.aidan@skinner.demon.co.uk>
 <380CA5AC.82499FE2@ftw.rsc.raytheon.com> <7um9ji$dor$1@nnrp1.deja.com>
Organization: MindSpring Enterprises
X-Server-Date: 22 Oct 1999 18:04:40 GMT
Newsgroups: comp.lang.ada
Date: 1999-10-22T18:04:40+00:00
List-Id: <comp.lang.ada>

In article <7um9ji$dor$1@nnrp1.deja.com>,
	Robert Dewar <robert_dewar@my-deja.com> wrote:

>My own view is that good names are an *adjunct* to good
>comments, not a substitute for them.

Many software products developed in Ada are based on some
larger systems engineering specification.  The software must
reflect the constraints of that specification.  For example,
in one communications satellite software effort, it was common
to see comments that referred back to a paragraph of the
engineering specification.  

It would have been quite foolhardy to rely only on the names of
the entities.   Many of these names described some complicated
calculation that could only be understood by looking at the
underlying mathematics in the engineering specification.  For
trivial programs in which one is simply getting and putting
data to and from files, meaningful names might be enough. For
serious engineering applications, we need comments that correspond
to the original specification.  

As usual, we use the kind of tools appropriate for the problem
space and solution space.  I am beginning to think that people who
make up hard and fast rules for computer programming are people who
no longer actually write programs.  Perhaps they never did.

Richard Riehle
http://www.adaworks.com