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: Wes Groleau Subject: Comments (was: Self-referential types) Date: 1999/10/21 Message-ID: <380F2BA5.1EEE15F1@ftw.rsc.raytheon.com>#1/1 X-Deja-AN: 538870852 Content-Transfer-Encoding: 7bit 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-Accept-Language: en,es,fr,pt Content-Type: text/plain; charset=us-ascii X-Complaints-To: news@icg.raytheon.com X-Trace: bos-service2.ext.raytheon.com 940518319 151.168.144.162 (Thu, 21 Oct 1999 10:05:19 CDT) Organization: Raytheon Company MIME-Version: 1.0 NNTP-Posting-Date: Thu, 21 Oct 1999 10:05:19 CDT Newsgroups: comp.lang.ada Date: 1999-10-21T00:00:00+00:00 List-Id: > > If good naming conventions are used, [nested procedures] > > 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. My own view is comments like the following are worse than unnecessary, they are pure clutter: -- check whether the current transaction is completed if Is_Completed (Current_Transaction) then -- if so, close the source and destination DB files DB_IO.Close (Source); DB_IO.Close (Destination); I can't count the number of times I have seen code (in many languages) with many useless comments like the above, but with NONE of the comments it really needed. I suspect "my own view" and "your own view" are the same, but we're applying them to different things.