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: 103376,23963231b5359f74 X-Google-Attributes: gid103376,public X-Google-Thread: 1073c2,23963231b5359f74 X-Google-Attributes: gid1073c2,public X-Google-Thread: 107a89,23963231b5359f74 X-Google-Attributes: gid107a89,public X-Google-Thread: 10a146,23963231b5359f74 X-Google-Attributes: gid10a146,public X-Google-Thread: 11440e,23963231b5359f74 X-Google-Attributes: gid11440e,public X-Google-Thread: 101deb,23963231b5359f74 X-Google-Attributes: gid101deb,public X-Google-ArrivalTime: 2001-06-07 20:37:46 PST Path: archiver1.google.com!newsfeed.google.com!sn-xit-02!sn-xit-04!sn-xit-01!supernews.com!newshub2.rdc1.sfba.home.com!news.home.com!news2.rdc2.tx.home.com.POSTED!not-for-mail Message-ID: <3B2048B1.DF27DE97@home.com> From: Larry Elmore X-Mailer: Mozilla 4.77 [en] (X11; U; Linux 2.4.5 i586) X-Accept-Language: en MIME-Version: 1.0 Newsgroups: comp.lang.ruby,comp.lang.ada,comp.lang.awk,comp.lang.clarion,comp.lang.java.programmer,comp.lang.pl1,comp.lang.vrml Subject: Re: Commenting code 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> <3b1ffa9a.10556848@pubnews.netcom.net.uk> Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit Date: Fri, 08 Jun 2001 03:37:45 GMT NNTP-Posting-Host: 65.10.25.74 X-Complaints-To: abuse@home.net X-Trace: news2.rdc2.tx.home.com 991971465 65.10.25.74 (Thu, 07 Jun 2001 20:37:45 PDT) NNTP-Posting-Date: Thu, 07 Jun 2001 20:37:45 PDT Organization: Excite@Home - The Leader in Broadband http://home.com/faster Xref: archiver1.google.com comp.lang.ruby:10474 comp.lang.ada:8382 comp.lang.awk:2880 comp.lang.clarion:21395 comp.lang.java.programmer:74606 comp.lang.pl1:886 comp.lang.vrml:3624 Date: 2001-06-08T03:37:45+00:00 List-Id: Jane Williams wrote: > > On Thu, 07 Jun 2001 21:58:10 GMT, Roedy Green > wrote: > > >however, sometimes there is nothing really useful you could add: > >e.g. > > > >"getZipPlusFive get the US Zip+5 postal code." > > I'd say that was useful comment, myself. Never having heard of > anything called "zip+5", I would not have guessed that it was a postal > code. Even being an American, I would be confused -- I've heard of Zip+4, but would think this _must_ mean something other than postal code without the comment. > Two words of added information: great! If all you'd said was > "gets the zip plus five code" then I'd agree that the comment would be > useless. As it is, I'd still be bemused and trying to find out if a new standard had been enacted, or if the programmer (and their program) had seriously bad assumptions! Larry