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: 1014db,30e368bdb3310fe5 X-Google-Attributes: gid1014db,public X-Google-Thread: f8c65,30e368bdb3310fe5 X-Google-Attributes: gidf8c65,public X-Google-Thread: 103376,30e368bdb3310fe5 X-Google-Attributes: gid103376,public X-Google-Thread: 1008e3,30e368bdb3310fe5 X-Google-Attributes: gid1008e3,public X-Google-Thread: 10db24,30e368bdb3310fe5 X-Google-Attributes: gid10db24,public From: z007400b@bcfreenet.seflin.lib.fl.us (Ralph Silverman) Subject: Re: The Last Word on Comments (was Re: Hungarian notation) Date: 1996/06/28 Message-ID: <4r1bdp$3ib@nntp.seflin.lib.fl.us>#1/1 X-Deja-AN: 162628537 references: <31bf6e29.185297643@netline-fddi.jpl.nasa.gov> <31C685A1.F1@wgs.estec.esa.nl> <4q79lr$ju5@panix3.panix.com> followup-to: comp.lang.ada,comp.lang.c++,comp.lang.c,comp.lang.modula3,comp.lang.modula2,comp.edu,comp.lang.eiffel organization: SEFLIN Free-Net - Broward 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: Robert Dewar (dewar@cs.nyu.edu) wrote: : zink@panix said : ">My feeling after years of programming is that the only meaningful : >documentation a procedure carries are the documentation of its : >interface and its evolution, and the code itself." : One thing that is interesting in this thread is the extraordinary range : of views on this point. It is valuable for everyone to realize that this : range exists, because it is fairly important that a project take a : reasonably consistent attitude. : I certainly would not like zink to be generating comment-free source : code anywhere near any of my programs, and no doubt zink would hate : my commented code. : So this is definitely something to add to interview profiles, and other : evaluations! -- ************begin r.s. response************* suppose discussion relates to working code yes ? source is determinative of behavior, certainly, in a way comments can not be, yes ? comments can be wrong in a ^^^^^ fundamental way source is not, yes ? on this view comments are less to be trusted! (just add common sense!) those who have faith in comments as a shortcut to understanding code are sure to get burned by this ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ sooner or later... the argument here is, generally, between those who have been burned and those who will be burned!!! ************end r.s. response*************** Ralph Silverman z007400b@bcfreenet.seflin.lib.fl.us