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.3 required=5.0 tests=BAYES_00,INVALID_MSGID autolearn=no autolearn_force=no version=3.4.4 X-Google-Language: ENGLISH,ASCII-7-bit X-Google-Thread: fac41,af40e09e753872c X-Google-Attributes: gidfac41,public X-Google-Thread: 109fba,f292779560fb8442 X-Google-Attributes: gid109fba,public X-Google-Thread: 10db24,30e368bdb3310fe5 X-Google-Attributes: gid10db24,public X-Google-Thread: 1014db,30e368bdb3310fe5 X-Google-Attributes: gid1014db,public X-Google-Thread: 1008e3,30e368bdb3310fe5 X-Google-Attributes: gid1008e3,public X-Google-Thread: f8c65,30e368bdb3310fe5 X-Google-Attributes: gidf8c65,public X-Google-Thread: 103376,30e368bdb3310fe5 X-Google-Attributes: gid103376,public From: ok@goanna.cs.rmit.EDU.AU (Richard A. O'Keefe) Subject: Re: Hungarian notation Date: 1996/05/28 Message-ID: <4oeh0n$o6g@goanna.cs.rmit.EDU.AU>#1/1 X-Deja-AN: 157122928 references: <31999F43.41C67EA6@scn.de> <319D2278.3F9A@netonecom.net> <4nr50r$jo2@ringer.cs.utsa.edu> <4ns02o$ep3@goanna.cs.rmit.EDU.AU> <4o07o9$rfu@seagoon.newcastle.edu.au> <31a4f8b5.80438504@sqarc.sq.com> organization: Comp Sci, RMIT, Melbourne, Australia newsgroups: comp.lang.ada,comp.lang.c++,comp.lang.c,comp.lang.modula3,comp.lang.modula2,comp.edu,comp.lang.eiffel nntp-posting-user: ok Date: 1996-05-28T00:00:00+00:00 List-Id: willer@carolian.com (Steve Willer) writes: >I wish teachers would also stress the need for writing code that's as >self-documenting as possible. If it's possible to make code very clear >without comments, I feel that's much more valuable than adding comments. I do. In the past I've spent a lot of time preaching the Gospel about identifiers: an identifier's name cannot tell you the *whole* truth about what it means, but it should tell you nothing *but* the truth, and it should do so clearly and simply. And then students go and do things like struct rectypes { PersonList *Plist; MatingList *Mlist; }; (pasted from an actual assignment in another window). Do I need to point out that the "PersonList" type is not a list? This is one of those things that you just don't appreciate until you try to read someone else's code. Does anyone know where I can find a non-trivial body of *well-written* C or C++ code? I've looked all over, and the only stuff I found was pre-ANSI. -- Fifty years of programming language research, and we end up with C++ ??? Richard A. O'Keefe; http://www.cs.rmit.edu.au/~ok; RMIT Comp.Sci.