Re: [PATCH] mount: add btrfs to mount.8

[Gui Hecheng <guihc.fnst@cn.fujitsu.com>]

On Fri, 2014-06-06 at 11:44 +0200, Karel Zak wrote:
> On Fri, Jun 06, 2014 at 02:32:39PM +0800, Gui Hecheng wrote:
> > But for now, there are btrfs *users* complaining that they cannot find
> > any help by refering to the mount manpage when they want to mount their
> > btrfs. Actually, not every btrfs user have the mood to check the
> > Documentation/filesystems/btrfs.txt or anywhere else when they just want
> > to use a simple mount cmd. 
> 
>  The kernel is the "ideal place", but it's more dream than anything
>  else... what we use for example for NFS is to maintain FS specific
>  man page in userspace FS package (e.g. nfs-utils).
Ah, thanks for explaining so much to me, I can't agree more.

>  Wouldn't be possible to add the man page to btrfs-progs package? The
>  package is maintained by btrfs guys and I guess all btrfs users have
>  very probably installed the package.
Actually, we just would like to see btrfs "staying with" ext4, xfs and
other fs together. We feel a bit sad that ext4 and xfs both have stuff
in mount.8 but btrfs doesn't.

> > So, If it does not bother you much... 
> 
>  I personally have no problem to maintain information about arbitrary
>  FS in mount.8, the problem are updates. Unfortunately, kernel FS developers
>  don't care about the man page at all and it's very often not up to date.
> 
>  [My experience is very bad. Not sure why, but for many kernel devels
>   commit into Linus' tree is end of their work, they don't care if there
>   is usable userpsace util or docs for users, people like Eric Biederman
>   or Lukas Czerner are rare exception.]
Thanks for sharing the story with me, I really get a lot.

> > And I think there are many btrfs developers who will be
> > glad to continue helping correct the btrfs part.
> 
>  OK, we can try it, if you still prefer mount.8.
Our guys will try our best to keep the mount.8 for btrfs up-to-date.
At least, you have my promise.

Thanks,
-Gui

>     Karel
>