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: 11440e,23963231b5359f74 X-Google-Attributes: gid11440e,public X-Google-Thread: 1073c2,23963231b5359f74 X-Google-Attributes: gid1073c2,public X-Google-Thread: 107a89,23963231b5359f74 X-Google-Attributes: gid107a89,public X-Google-Thread: 103376,23963231b5359f74 X-Google-Attributes: gid103376,public X-Google-Thread: 101deb,23963231b5359f74 X-Google-Attributes: gid101deb,public X-Google-Thread: 10a146,23963231b5359f74 X-Google-Attributes: gid10a146,public X-Google-ArrivalTime: 2001-06-07 01:41:29 PST Path: archiver1.google.com!newsfeed.google.com!sn-xit-02!supernews.com!nntp-relay.ihug.net!ihug.co.nz!newsfeed00.sul.t-online.de!t-online.de!colt.net!newspeer.clara.net!news.clara.net!server3.netnews.ja.net!newshost.central.susx.ac.uk!news.bton.ac.uk!not-for-mail From: John English 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: Long names are doom ? Date: Thu, 07 Jun 2001 09:10:44 +0100 Organization: University of Brighton Message-ID: <3B1F3704.C7E0D03A@brighton.ac.uk> References: <83WP6.3874$yc6.728572@news.xtra.co.nz> <3B1411D0.3AAF42E7@ftw.rsc.raytheon.com> <9f2nks$ibd$0@dosa.alt.net> <3B177EF7.2A2470F4@facilnet.es> <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> NNTP-Posting-Host: dialin-b6.bton.ac.uk Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit X-Trace: saturn.bton.ac.uk 991901401 15226 194.81.199.186 (7 Jun 2001 08:10:01 GMT) X-Complaints-To: news@bton.ac.uk NNTP-Posting-Date: 7 Jun 2001 08:10:01 GMT X-Mailer: Mozilla 4.6 [en] (Win95; I) X-Accept-Language: en,pdf Xref: archiver1.google.com comp.lang.ruby:10442 comp.lang.ada:8291 comp.lang.awk:2837 comp.lang.clarion:21283 comp.lang.java.programmer:74328 comp.lang.pl1:836 comp.lang.vrml:3577 Date: 2001-06-07T08:10:01+00:00 List-Id: Gary Scott wrote: > "Readability" can be far better achieved through the proper use of > comments. While variable names should be "understandable" (you decide > what that means), the implication that > variables/procedure/class/member/etc names must be full english words is > a red herring. The CODE does not necessarily need to be so obsessively > verbose, the commentary needs to be verbose (or "sufficiently" so). The trouble is with comments is that they aren't checked by the compiler, are often not maintained properly when the code is, and can therefore be misleading. I'd much prefer the code to provide the information that would otherwise go in the comments, and the use of meaningful names (not necessarily verbose, just meaningful) goes a long way towards achieving that. That way my "commentary" is checkable by the compiler. ----------------------------------------------------------------- John English | mailto:je@brighton.ac.uk Senior Lecturer | http://www.comp.it.bton.ac.uk/je Dept. of Computing | ** NON-PROFIT CD FOR CS STUDENTS ** University of Brighton | -- see http://burks.bton.ac.uk -----------------------------------------------------------------