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: f8c65,30e368bdb3310fe5 X-Google-Attributes: gidf8c65,public X-Google-Thread: 103376,30e368bdb3310fe5 X-Google-Attributes: gid103376,public X-Google-Thread: 1014db,30e368bdb3310fe5 X-Google-Attributes: gid1014db,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/23 Message-ID: #1/1 X-Deja-AN: 161815193 references: <4q79lr$ju5@panix3.panix.com> <4qkdvu$j48@panix3.panix.com> 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-23T00:00:00+00:00 List-Id: zink said "On my side I'd want to see what your "commented" code was like before I passed any judgements. But you're probably right--I've dealt with a lot of academics' code in the past." a) you can see it rather easily, have a look at the GNAT sources, the commenting style is pretty consistent, and very much in line with how I think code should be commented (much of it is my own code!) b) I have delivered over a million lines of commercial code in all sorts of languages, and always tried to maintain a very high level of documentation (if you want to see some of my assembly language, get a hold of the SPITBOL 360 implementation to see my commenting style there). You may not like my commenting style, but I do *not* think that you can blame it on my academic connections -- if you don't like it, you just don't like it :-) Robert Now, how about letting us see a reasonably large program (order of 100K SLOC) program that *you* have written, so we can also pass our own judgment :-)