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.9 required=5.0 tests=BAYES_00 autolearn=ham autolearn_force=no version=3.4.4 X-Google-Language: ENGLISH,ASCII-7-bit X-Google-Thread: 10ad19,23963231b5359f74 X-Google-Attributes: gid10ad19,public X-Google-Thread: 107a89,23963231b5359f74 X-Google-Attributes: gid107a89,public X-Google-Thread: 103376,23963231b5359f74 X-Google-Attributes: gid103376,public X-Google-Thread: 1073c2,23963231b5359f74 X-Google-Attributes: gid1073c2,public X-Google-Thread: 101deb,23963231b5359f74 X-Google-Attributes: gid101deb,public X-Google-Thread: 10a146,23963231b5359f74 X-Google-Attributes: gid10a146,public X-Google-Thread: 11440e,23963231b5359f74 X-Google-Attributes: gid11440e,public X-Google-ArrivalTime: 2001-06-13 10:33:58 PST Path: archiver1.google.com!newsfeed.google.com!sn-xit-02!supernews.com!newsfeed.direct.ca!look.ca!newsfeed.cwix.com!sjc-peer.news.verio.net!news.verio.net!iad-read.news.verio.net.POSTED!not-for-mail Newsgroups: comp.lang.ruby,comp.lang.ada,comp.lang.awk,comp.lang.clarion,comp.lang.java.programmer,comp.lang.pl1,comp.lang.vrml References: <9f8b7b$h0e$1@nh.pace.co.uk> <9f8r0i$lu3$1@nh.pace.co.uk> <9fgagu$6ae$1@nh.pace.co.uk> <9fjgha$blf$1@nh.pace.co.uk> <35mqhtkdfma2rggv1htcaq6vfn2ihs67a1@4ax.com> <3B1E1452.BAFAAB7F@baesystems.com> <3B1E4B93.7FB8A94D@lmtas.lmco.com> <3B1F3704.C7E0D03A@brighton.ac.uk> <3b20d633$8$fuzhry$mr2ice@va.news.verio.net> <3B20EDAC.5A4F7BD4@home.com> From: "Shmuel (Seymour J.) Metz" Subject: Re: Commenting code Mail-Copies-To: nobody Organization: Atid/2 X-Cise: "Tony Schliesser" X-CompuServe-Customer: Yes X-Coriate: NCAE@NewAmerica.org X-Ecrate: Bob Germer X-Punge: Micro$oft X-Sanguinate: themvsguy@email.com X-Terminate: SPA(GIS) Message-ID: <3b27569c$1$fuzhry$mr2ice@va.news.verio.net> X-Newsreader: MR/2 Internet Cruiser Edition for OS/2 v2.28a/28 Date: Wed, 13 Jun 2001 08:03:40 -0400 NNTP-Posting-Host: 206.55.10.86 X-Complaints-To: abuse@verio.net X-Trace: iad-read.news.verio.net 992437038 206.55.10.86 (Wed, 13 Jun 2001 12:57:18 GMT) NNTP-Posting-Date: Wed, 13 Jun 2001 12:57:18 GMT Xref: archiver1.google.com comp.lang.ruby:10568 comp.lang.ada:8672 comp.lang.awk:3034 comp.lang.clarion:21830 comp.lang.java.programmer:76025 comp.lang.pl1:999 comp.lang.vrml:3762 Date: 2001-06-13T08:03:40-04:00 List-Id: In <3B20EDAC.5A4F7BD4@home.com>, on 06/08/2001 at 03:22 PM, "Donald L. Dobbs" said: >label: ADC A,$01 >This is a perfectly good instruction to do an add with carry to the >accumulator A. >So what? But if you add the comment "Increment the shaft encoder >counter until limit reached" then I have some idea of what the code >is SUPPOSED to be doing and how that snippet of code relates to the >overall problem to be solved. Nu? In what way does that echo the code? If, instead, you add the comment "increment the accumulator with carry", would you defend the comment as necessary? -- ----------------------------------------------------------- Shmuel (Seymour J.) Metz, SysProg and JOAT Atid/2 Team OS/2 Team PL/I Any unsolicited commercial junk E-mail will be subject to legal action. I reserve the right to publicly post or ridicule any abusive E-mail. I mangled my E-mail address to foil automated spammers; reply to domain acm dot org user shmuel to contact me. Do not reply to spamtrap@library.lspace.org -----------------------------------------------------------