On Sep 13, 2005, at 11:44 AM, Perry E. Metzger wrote:

> I have to say I disagree. Often, in trying to debug one portion of the
> kernel or another, it is VERY valuable to understand the inside of how
> that portion of the kernel works. The 4.4 book is pretty old at this
> point and was woefully incomplete.

In this particular case, no other part of the kernel interacts with  
the code being documented.  It is only referenced in the context of  
itself.

> Surely you don't think less documentation is better than more?

I like more documentation.  But I think having a tmpfs(9) manual page  
is confusing to people who are looking for more information about  
kernel APIs, because tmpfs isn't one.  So put the documentation in  
the appropriate place, which in this case is a README in the  
directory that holds the tmpfs source code.

-- thorpej