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: 109fba,f292779560fb8442 X-Google-Attributes: gid109fba,public X-Google-Thread: fac41,af40e09e753872c X-Google-Attributes: gidfac41,public X-Google-Thread: 10db24,30e368bdb3310fe5 X-Google-Attributes: gid10db24,public X-Google-Thread: 103376,30e368bdb3310fe5 X-Google-Attributes: gid103376,public X-Google-Thread: 1014db,30e368bdb3310fe5 X-Google-Attributes: gid1014db,public X-Google-Thread: f8c65,30e368bdb3310fe5 X-Google-Attributes: gidf8c65,public X-Google-Thread: 1008e3,30e368bdb3310fe5 X-Google-Attributes: gid1008e3,public From: dewar@cs.nyu.edu (Robert Dewar) Subject: Re: The Last Word on Comments (was Re: Hungarian notation) Date: 1996/06/28 Message-ID: #1/1 X-Deja-AN: 162820345 references: <31bf6e29.185297643@netline-fddi.jpl.nasa.gov> <31C685A1.F1@wgs.estec.esa.nl> <4q79lr$ju5@panix3.panix.com> <4r1bdp$3ib@nntp.seflin.lib.fl.us> organization: Courant Institute of Mathematical Sciences newsgroups: comp.lang.ada,comp.lang.c++,comp.lang.c,comp.lang.modula3,comp.lang.modula2,comp.edu,comp.lang.eiffel Date: 1996-06-28T00:00:00+00:00 List-Id: " comments can be wrong in a ^^^^^ fundamental way source is not," This is wrong. It seems right only if you have no sense of abstraction. The code is *way* over-specified. The function of comments (or one of many functions) is to comment things at the right level of abstraction and at the right level of specification. The fact that you have been burned by your own and others inadequate comments inadequately maintained is not a good reason for suggesting that others who are perfectly capable of writing good comments and maintaining them should not do so!