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.5 required=5.0 tests=BAYES_00,INVALID_MSGID, PP_MIME_FAKE_ASCII_TEXT autolearn=no autolearn_force=no version=3.4.4 X-Google-Language: ENGLISH,ASCII X-Google-Thread: 103376,e94a7e4f6f888766 X-Google-Attributes: gid103376,public From: "Jean-Pierre Rosen" Subject: Re: Self-referential types Date: 1999/10/21 Message-ID: <7un1me$6jm$1@wanadoo.fr>#1/1 X-Deja-AN: 538819320 References: <7ttb4a$8mq$1@nnrp1.deja.com> <3802f2db_2@news1.prserv.net> <3803B5E3.F96A6DD4@mitre.org> <3803c8bc_2@news1.prserv.net> <3804E7E0.6A0265FB@mitre.org> <38077EB3.E6911567@mitre.org> <380CA5AC.82499FE2@ftw.rsc.raytheon.com> <7um9ji$dor$1@nnrp1.deja.com> X-Priority: 3 X-Mimeole: Produced By Microsoft MimeOLE V5.00.2014.211 X-Complaints-To: abuse@wanadoo.fr X-Trace: wanadoo.fr 940509710 6774 164.138.50.138 (21 Oct 1999 12:41:50 GMT) Organization: Adalog X-MSMail-Priority: Normal NNTP-Posting-Date: 21 Oct 1999 12:41:50 GMT Newsgroups: comp.lang.ada Date: 1999-10-21T12:41:50+00:00 List-Id: Robert Dewar a �crit dans le message : 7um9ji$dor$1@nnrp1.deja.com... > In article <380CA5AC.82499FE2@ftw.rsc.raytheon.com>, > Wes Groleau 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. > I would say it the other way round: Not everything can be put in good names, therefore comments are necessary to express what cannot be put in the name. But if the info is in the name, then it is repeated each time it is used; therefore, I would discourage something like this: LL : Natural ; -- this is the line length in favour of the (comment-less): Line_Length : Natural; -- --------------------------------------------------------- J-P. Rosen (Rosen.Adalog@wanadoo.fr) Visit Adalog's web site at http://pro.wanadoo.fr/adalog