From owner-freebsd-chat@FreeBSD.ORG Tue Apr 22 16:10:30 2003 Return-Path: Delivered-To: freebsd-chat@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id DA40E37B401 for ; Tue, 22 Apr 2003 16:10:30 -0700 (PDT) Received: from tartarus.telenet-ops.be (tartarus.telenet-ops.be [195.130.132.46]) by mx1.FreeBSD.org (Postfix) with ESMTP id 7C2B143FBF for ; Tue, 22 Apr 2003 16:10:29 -0700 (PDT) (envelope-from philip@paeps.cx) Received: from localhost (localhost.localdomain [127.0.0.1]) by tartarus.telenet-ops.be (Postfix) with SMTP id EC137DB9A8; Wed, 23 Apr 2003 01:10:27 +0200 (CEST) Received: from fortuna.home.paeps.cx (D5768746.kabel.telenet.be [213.118.135.70]) by tartarus.telenet-ops.be (Postfix) with ESMTP id A91B7DB99F; Wed, 23 Apr 2003 01:10:27 +0200 (CEST) Received: from juno.home.paeps.cx (juno.home.paeps.cx [2001:ab8:2007:0:240:f4ff:fe31:3090]) by fortuna.home.paeps.cx (Postfix) with ESMTP id 7F4462098; Wed, 23 Apr 2003 01:10:27 +0200 (CEST) Received: by juno.home.paeps.cx (Postfix, from userid 1001) id 401D620CC; Wed, 23 Apr 2003 01:10:27 +0200 (CEST) Date: Wed, 23 Apr 2003 01:10:27 +0200 From: Philip Paeps To: freebsd-chat@freebsd.org Message-ID: <20030422231027.GV666@juno.home.paeps.cx> Mail-Followup-To: freebsd-chat@freebsd.org, Jonathon McKitrick References: <5.0.2.1.1.20030422171035.01c5e258@popserver.sfu.ca> <5.0.2.1.1.20030422205617.0387b378@popserver.sfu.ca> Mime-Version: 1.0 Content-Type: text/plain; charset=iso-8859-15 Content-Disposition: inline In-Reply-To: <5.0.2.1.1.20030422205617.0387b378@popserver.sfu.ca> X-Date-in-Rome: ante diem IX Kalendas Maias MMDCCLVI ab Urbe Condida X-PGP-Fingerprint: FA74 3C27 91A6 79D5 F6D3 FC53 BF4B D0E6 049D B879 X-Message-Flag: Get a proper mailclient! Mutt: User-Agent: Mutt/1.5.4i cc: Jonathon McKitrick Subject: Re: Code layout and debugging time X-BeenThere: freebsd-chat@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Non technical items related to the community List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 22 Apr 2003 23:10:31 -0000 On 2003-04-22 21:01:01 (+0100), Colin Percival wrote: > At 12:14 22/04/2003 -0700, Terry Lambert wrote: > > If you ever find and Open Source that qualifies as "heavily commented", > > let us know, and we can go take a look. > > Well, not Open Source, but I have seen quite a few undergraduate programming > assignments which have "pixie dust" comments. Some people take their > instructors' advice to "comment everything you write" a bit too seriously, I > think. Instructors often neglect to mention that if it can be said in code, there's really no point in saying it again in a comment :-) I occasionally even see things like this: /* this prints a line of text */ fprintf(stdout, "a line of text\n"); Completely pointless. The same people who will write that, however, will also indulge in writing long blocks of extremely creative and 'dense' code, without a comment anywhere in sight. *sigh* Someone should write a book about how to comment code. Or a language which ignores code and only compiles comments. Like 'whitespace' which ignores everything other than whitespace :-) - Philip -- Philip Paeps Please don't CC me, I am philip@paeps.cx subscribed to the list. You're ugly and your mother dresses you funny.