YAMAMOTO Takashi <yamt@mwd.biglobe.ne.jp> writes:
> it makes sense for interface descriptions like vnode(9).
> and it might make sense for high-level design explanation.
>
> however, in this case, what we are talking about are merely
> implementation details.
> IMO, having comments near the code is better,
> especially for immature and changing code like this.

We can always do both. :)

I tend to agree that it is necessary to have the comments in the code
as well.

Perry