From owner-freebsd-chat@FreeBSD.ORG Tue Apr 22 13:31:15 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 8750637B401 for ; Tue, 22 Apr 2003 13:31:15 -0700 (PDT) Received: from heron.mail.pas.earthlink.net (heron.mail.pas.earthlink.net [207.217.120.189]) by mx1.FreeBSD.org (Postfix) with ESMTP id E82B943FCB for ; Tue, 22 Apr 2003 13:31:14 -0700 (PDT) (envelope-from tlambert2@mindspring.com) Received: from pool0258.cvx40-bradley.dialup.earthlink.net ([216.244.43.3] helo=mindspring.com) by heron.mail.pas.earthlink.net with asmtp (SSLv3:RC4-MD5:128) (Exim 3.33 #1) id 1984MH-00048C-00; Tue, 22 Apr 2003 13:27:17 -0700 Message-ID: <3EA5A53F.3016395C@mindspring.com> Date: Tue, 22 Apr 2003 13:25:35 -0700 From: Terry Lambert X-Mailer: Mozilla 4.79 [en] (Win98; U) X-Accept-Language: en MIME-Version: 1.0 To: Colin Percival References: <5.0.2.1.1.20030422171035.01c5e258@popserver.sfu.ca> <5.0.2.1.1.20030422205617.0387b378@popserver.sfu.ca> Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit X-ELNK-Trace: b1a02af9316fbb217a47c185c03b154d40683398e744b8a4e9540a5a9b9950a70cad90bbc45d0672667c3043c0873f7e350badd9bab72f9c350badd9bab72f9c cc: Jonathon McKitrick cc: freebsd-chat@freebsd.org 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 20:31:15 -0000 Colin Percival wrote: > At 12:14 22/04/2003 -0700, Terry Lambert wrote: > >I think that there would not be a similar effect, unless the > >comments were sprinkled throughout the code like pixie dust. > >8-). [snip] > >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. It could also be a matter of "available tools"; for example, people with comment-folding editors will be much more likely to comment the bejesus out of things, and make them unreadable to people without the same tools. Or people with Emacs will make code unreadable to everyone else... 8-) 8-) }B^). People with "vi" (and people who know how to use "grep") tend to declare functions: int foo(void) Rather than: int foo(void) Because they can search for declarations of a single function in a large amount of source code by anchoring the search to the start of the line... e.g.: cd /usr/src/sys find . -type f | xargs grep \^pmap_enter ...Of course, that's just because they haven't learned about "tags" files yet, I think... 8-) 8-O }B^). -- Terry