Re: [PATCH] mount(8): drop redundant filesystem-specific sections

[Mike Frysinger <vapier@gentoo.org>]

[-- Attachment #1: Type: text/plain, Size: 1210 bytes --]

On 22 Jan 2018 10:09, Karel Zak wrote:
> On Fri, Jan 19, 2018 at 01:45:20PM -0500, Mike Frysinger wrote:
> > Add a new section to the top of the filesystem-specific chapter to point
> > people generally to the filesystem-specific man pages.  This way we can
> > delete all the redundant subsections that say the same thing.
> 
> Well, the subsections also provides the name of the package where is FS
> specific man page :-)
> 
> > -.SS "Mount options for xfs"
> > -See the options section of the
> > -.BR xfs (5)
> > -man page (the xfsprogs package must be installed).
> 
> It's probably not so important (and I have no strong opinion about
> it), but I can imagine that for end-users it's useful. Maybe we can
> add to the man page a small table with FS name, man page and package
> name:
> 
>       xfs   xfs(5)          xfsprogs
>       ext4  ext4(5)         e2fsprogs
>       cifs  mount.cifs(8)   cifs-utils
>       ...
> 
> or is it overkill?

the only reason i hesitated to try and do that was due to cross-distro
package naming idiosyncrasies.  but i guess if we refer to the upstream
project using the name they choose, the rest can be an exercise for the
user ?
-mike

[-- Attachment #2: Digital signature --]
[-- Type: application/pgp-signature, Size: 833 bytes --]