Date: Tue, 22 Apr 2003 12:14:21 -0700 From: Terry Lambert <tlambert2@mindspring.com> To: Colin Percival <colin.percival@wadham.ox.ac.uk> Cc: freebsd-chat@freebsd.org Subject: Re: Code layout and debugging time Message-ID: <3EA5948D.EDB810B2@mindspring.com> References: <5.0.2.1.1.20030422171035.01c5e258@popserver.sfu.ca>
next in thread | previous in thread | raw e-mail | index | archive | help
Colin Percival wrote: > It would be interesting to see if a similar effect can be observed > in heavily commented code; I have a feeling that one might find that > writing comments into a distinct "documentation" file would have an > advantage over the usual practice of writing comments in the middle of code. I think that there would not be a similar effect, unless the comments were sprinkled throughout the code like pixie dust. 8-). If they were in discrete blocks, that would be something else (see, for example, the UFS header files, or vfs_subr.c, where it talks about soft updates and the syncer). If you ever find and Open Source that qualifies as "heavily commented", let us know, and we can go take a look. 8-) 8-) 8-). -- Terry
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?3EA5948D.EDB810B2>