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.2 required=5.0 tests=BAYES_00,INVALID_MSGID,
	REPLYTO_WITHOUT_TO_CC 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: kilgallen@eisner.decus.org (Larry Kilgallen)
Subject: Re: Self-referential types
Date: 1999/10/21
Message-ID: <1999Oct21.075422.1@eisner>#1/1
X-Deja-AN: 538816079
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>
X-Trace: news.decus.org 940506866 26984 KILGALLEN [216.44.122.34]
Organization: LJK Software
Reply-To: Kilgallen@eisner.decus.org.nospam
Newsgroups: comp.lang.ada
Date: 1999-10-21T00:00:00+00:00
List-Id: <comp.lang.ada>

In article <7um9ji$dor$1@nnrp1.deja.com>, Robert Dewar <robert_dewar@my-deja.com> writes:
> In article <380CA5AC.82499FE2@ftw.rsc.raytheon.com>,
>   Wes Groleau <wwgrol@ftw.rsc.raytheon.com> wrote:
>> If good naming conventions are used, it can _greatly_ reduce
>> the need for comments.
> 
> My own view is that good names are an *adjunct* to good
> comments, not a substitute for them.

Well try this wording:

	If bad naming conventions are used, it can _greatly_ increase
	the need for comments.


	Example:

		declare

			--
			-- Despite what you might infer from our efforts
			-- to cloak the symbol table, the following
			-- contains the number of miles to the next city.
			--

			Weight_In_Kilograms : NATURAL := 0;

:-)

Larry Kilgallen