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