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 19:03:47 PST Newsgroups: comp.lang.ada Path: bga.com!news.sprintlink.net!howland.reston.ans.net!EU.net!uunet!telesoft!kst From: kst@alsys.com (Keith Thompson @pulsar) Subject: Re: Easily-Read C++? Message-ID: Sender: news@alsys.com (USENET News Admin @flash) Organization: Alsys Group, San Diego, CA, USA References: <941005030023_73672.2025_DHR103-1@CompuServe.COM> <36v7p4$amf@gnat.cs.nyu.edu> <36v90m$9r4@cmcl2.NYU.EDU> <124377@cup.portal.com> Date: Thu, 13 Oct 1994 00:51:11 GMT Date: 1994-10-13T00:51:11+00:00 List-Id: In <124377@cup.portal.com> R_Tim_Coslet@cup.portal.com writes: > 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! > > > >One company, either DEC (I think) or CDC (less likely) actively > >discouraged this sort of thing in their coding standard. > > Useless comments like that should be BANNED. I agree, but only 99% of the time. Comments should be designed for the enlightenment of the intended audience. In most cases, the intended audience is the person maintaining the code (possibly the original author, possibly someone else), who presumably is fluent in the language being used. If the line appears in chapter 1 of an introduction to PDP-11 assembly language, the comment "Add one to R0" is perfectly appropriate. -- Keith Thompson (The_Other_Keith) kst@alsys.com TeleSoft^H^H^H^H^H^H^H^H Alsys, Inc. 10251 Vista Sorrento Parkway, Suite 300, San Diego, CA, USA, 92121-2718 /user/kst/.signature: I/O error (core dumped)