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.8 required=5.0 tests=BAYES_00,INVALID_DATE autolearn=no autolearn_force=no version=3.4.4 X-Google-Language: ENGLISH,ASCII-7-bit X-Google-Thread: 103376,1ff5003422436e4 X-Google-Attributes: gid103376,public X-Google-ArrivalTime: 1994-10-12 18:39:32 PST Path: bga.com!news.sprintlink.net!howland.reston.ans.net!swrinde!news.uh.edu!uuneo.neosoft.com!Starbase.NeoSoft.COM!not-for-mail From: dweller@Starbase.NeoSoft.COM (David Weller) Newsgroups: comp.lang.ada Subject: Re: Easily-Read C++? Date: 11 Oct 1994 13:11:44 -0500 Organization: NeoSoft Internet Services +1 713 684 5969 Message-ID: <37ekh0$m22@Starbase.NeoSoft.COM> References: <941005030023_73672.2025_DHR103-1@CompuServe.COM> <36v7p4$amf@gnat.cs.nyu.edu> <36v90m$9r4@cmcl2.NYU.EDU> <124377@cup.portal.com> NNTP-Posting-Host: starbase.neosoft.com Date: 1994-10-11T13:11:44-05:00 List-Id: In article <124377@cup.portal.com>, wrote: >In article: 36v90m$9r4@cmcl2.NYU.EDU> > kenner@lab.ultra.nyu.edu (Richard Kenner) wrote: >>There are actually times when it can! Consider the following fragment >>of an assembler language program for the PDP-11 written by someone who >>was told to write a comment on every line: >> >> ADD #1,R0 ;Add one to R0. >> >>That actually *does* slow down reading! >> >Useless comments like that should be BANNED. > >If a comment can't say anything that the code doesn't already say, >either the comment shouldn't be there or maybe the comment needs >complete rethinking to ADD something that the code DOESN'T say (e.g. >what is in R0? "Add one to counter" or "Increment flight level" would >be MUCH more informative than simply repeating the code). Ben Brosgol wrote an article many years ago on correct commenting. He pointed out that the only thing worse than commenting the above code as "Increment R0 by 1" was to say "Decrement R0 by 1" :-) -- Proud (and vocal) member of Team Ada! (and Team OS/2) ||This is not your Ada -- Very Cool. Doesn't Suck. || father's Ada For all sorts of interesting Ada tidbits, run the command: ||________________ "finger dweller@starbase.neosoft.com | more" (or e-mail with "finger" as subj.) ObNitPick: Spelling Ada as ADA is like spelling C++ as CPLUSPLUS. :-)