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

[Karel Zak <kzak@redhat.com>]

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).

 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.

> 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.]
 
> 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.

    Karel

-- 
 Karel Zak  <kzak@redhat.com>
 http://karelzak.blogspot.com