Subject: Re: Documenting filesystem kernel options outside of options(4)
To: Michael-John Turner <mj@turner.org.za>
From: Magnus Eriksson <magetoo@fastmail.fm>
List: tech-kern
Date: 03/10/2006 11:37:51
On Thu, 9 Mar 2006, Michael-John Turner wrote:
> Two options:
> 1 - Include the required/optional kernel options (and only the kernel
> options) in the respective mount*.8 manual pages.
> 2 - Create a section 4 manual page for each filesystem type (ffs.4,
> cd9660.4, smbfs.4, etc), explaining in more detail what its for,
> certain key data structures, required and optional kernel options,
> etc (much like raid.4). The various mount*.8 could then refer to
> the *.4 for the particular filesystem.
>
[...]
> Any thoughts on this? Is it worthwhile creating such filesystem manual
> pages or documenting the kernel options in each mount* manpage (or both)?
> Should I rather spend my time on something more useful? :)
This user thinks that having real live manpages for the file systems would
be Really Nice. Looking in mount_<foo> seems counterintuitive, and the
file systems themselves aren't really described in depth at all now (are
they?).
MAgnus