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: 101deb,23963231b5359f74 X-Google-Attributes: gid101deb,public X-Google-Thread: 107a89,23963231b5359f74 X-Google-Attributes: gid107a89,public X-Google-Thread: 103376,23963231b5359f74 X-Google-Attributes: gid103376,public X-Google-Thread: 10a146,23963231b5359f74 X-Google-Attributes: gid10a146,public X-Google-Thread: 1073c2,23963231b5359f74 X-Google-Attributes: gid1073c2,public X-Google-Thread: 11440e,23963231b5359f74 X-Google-Attributes: gid11440e,public X-Google-ArrivalTime: 2001-06-04 09:34:05 PST Path: archiver1.google.com!newsfeed.google.com!newsfeed.stanford.edu!nntp.cs.ubc.ca!newsfeed.direct.ca!look.ca!newsfeed.bc.tac.net!news.bc.tac.net!not-for-mail Followup-To: comp.lang.ada Sender: blaak@TORUS 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: Choosing proper object names (was: Long names are doom ?) References: <3B0DBD4A.82943473@my-deja.net> <3B0DD011.88FCD00E@acm.org> <83WP6.3874$yc6.728572@news.xtra.co.nz> <3B1411D0.3AAF42E7@ftw.rsc.raytheon.com> <9f2nks$ibd$0@dosa.alt.net> <3B177EF7.2A2470F4@facilnet.es> From: Ray Blaak Message-ID: Organization: The Transcend X-Newsreader: Gnus v5.6.42/Emacs 19.34 Date: 04 Jun 2001 09:32:40 -0700 NNTP-Posting-Host: 208.181.209.61 X-Complaints-To: news@bctel.net X-Trace: news.bc.tac.net 991672431 208.181.209.61 (Mon, 04 Jun 2001 09:33:51 PDT) NNTP-Posting-Date: Mon, 04 Jun 2001 09:33:51 PDT Xref: archiver1.google.com comp.lang.ruby:10374 comp.lang.ada:8074 comp.lang.awk:2727 comp.lang.clarion:21027 comp.lang.java.programmer:73393 comp.lang.pl1:723 comp.lang.vrml:3455 Date: 2001-06-04T09:32:40-07:00 List-Id: Ted Dennison writes: > If you come across the declaration: > > Thread_List : Singly_Linked_List; > > ..it tells you a lot more relevent information than: > > Thread_List : Thread_Lists; More information yes, but to me this is information that the client should *not* be aware of when using it, ideally speaking. What the client should be aware of is that Thread_Lists (or Thread_List -- that is not my point here) is a container of threads such that one can get the first one, maybe the last, and the next. Whether that is single or doubly linked or even linked at all should be irrelevant to the client. That is, plural or not, the name should indicate what the object is, abstractly speaking, not how it is implemented. With regards to plurality, what guides me is if the name indicates accurately how can something be used. Do you have a list of threads or a list of thread lists? If the former than my preference is for: Pending_Threads : Threads; That is, I try to avoid the use of things like "List" in a type name, so as to free myself from dependencies on a particular implementation. (e.g. what it is changed to a hash table or array or something? "List" would be confusing to maintainers). But I do have a collection of threads, accessible somehow, and that is the important point. -- Cheers, The Rhythm is around me, The Rhythm has control. Ray Blaak The Rhythm is inside me, blaak@infomatch.com The Rhythm has my soul.