Return-Path: Received: from mail-wm0-f49.google.com ([74.125.82.49]:34284 "EHLO mail-wm0-f49.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751182AbcBOKZT (ORCPT ); Mon, 15 Feb 2016 05:25:19 -0500 Subject: Re: richacl(7) man page review comments To: Andreas Gruenbacher References: <56B770B6.7040803@gmail.com> <56B77262.7090107@gmail.com> <56C0F150.60008@gmail.com> Cc: mtk.manpages@gmail.com, "J. Bruce Fields" , linux-ext4 , XFS Developers , lkml , linux-fsdevel , Linux NFS Mailing List , linux-cifs@vger.kernel.org, Linux API , Dave Chinner , Christoph Hellwig , Anna Schumaker , Trond Myklebust , Jeff Layton , Andreas Dilger From: "Michael Kerrisk (man-pages)" Message-ID: <56C1A788.9020008@gmail.com> Date: Mon, 15 Feb 2016 11:25:12 +0100 MIME-Version: 1.0 In-Reply-To: Content-Type: text/plain; charset=utf-8 Sender: linux-nfs-owner@vger.kernel.org List-ID: Hi Andreas, On 02/15/2016 12:12 AM, Andreas Gruenbacher wrote: > On Sun, Feb 14, 2016 at 10:27 PM, Michael Kerrisk (man-pages) > wrote: >> On 02/12/2016 11:25 PM, Andreas Gruenbacher wrote: >>> We could sure move acl(5) and richacl(7) there. >> >> We already have acl(5) (now "acl(7)" in man pages) ;-). > > Hmm, I can't find that page either in > git://git.kernel.org/pub/scm/docs/man-pages/man-pages or on > http://man7.org/. Are you sure you don't mean xattr.7 == attr.5 which > documents the xattr syscall interface? You're right. I was confusing with xattr(7). So, I think it might make some sense to eventually move both of these into man-pages (for richacl(7), at least, it's probably worth delaying this for a bit), since they're describing kernel-user-space interfaces. I can see counter-arguments too, such as these pages are closely related to the corresponding user-space libraries you maintain. What do you think? Thanks, Michael -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/