Subject: Re: CVS commit: src/sys/fs/tmpfs
To: Perry E.Metzger <perry@piermont.com>
From: Jason Thorpe <thorpej@shagadelic.org>
List: source-changes
Date: 09/13/2005 11:53:31
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