Code layout and debugging time

[Terry Lambert]

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