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=0.2 required=5.0 tests=BAYES_00,INVALID_MSGID, REPLYTO_WITHOUT_TO_CC 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: f8c65,30e368bdb3310fe5 X-Google-Attributes: gidf8c65,public X-Google-Thread: 1014db,30e368bdb3310fe5 X-Google-Attributes: gid1014db,public X-Google-Thread: 103376,30e368bdb3310fe5 X-Google-Attributes: gid103376,public X-Google-Thread: 1008e3,30e368bdb3310fe5 X-Google-Attributes: gid1008e3,public From: jab@iol.ie (Janus) Subject: Re: Hungarian notation Date: 1996/05/28 Message-ID: <4ofah2$cto@nuacht.iol.ie>#1/1 X-Deja-AN: 157177827 references: <31999F43.41C67EA6@scn.de> <4o07o9$rfu@seagoon.newcastle.edu.au> <4o1vo3$p2a@news1.ni.net> <4oehnp$onn@goanna.cs.rmit.EDU.AU> organization: KerryNet reply-to: jab@iol.ie newsgroups: comp.lang.ada,comp.lang.c++,comp.lang.c,comp.lang.modula3,comp.lang.modula2,comp.edu,comp.lang.eiffel Date: 1996-05-28T00:00:00+00:00 List-Id: ok@goanna.cs.rmit.EDU.AU (Richard A. O'Keefe) wrote: >I like reducing things to slogans. >I haven't been able to come up with a good one for this. >What I say is > "Your comments should tell a human reader precisely the > things s/he needs to understand the purpose and operation > of the module but are not obvious from the code." >This is the right stuff, but it needs to be said better. >Can anyone come up with a really memorable way of expressing this? "I understand c, I don't understand your program, explain it." Bye from Janus at Kerry, Ireland email : jab@iol.ie WWW : http://www.iol.ie/~jab