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