xfs
[Top] [All Lists]

Re: richacl(7) man page review comments

To: Andreas Gruenbacher <agruenba@xxxxxxxxxx>
Subject: Re: richacl(7) man page review comments
From: "Michael Kerrisk (man-pages)" <mtk.manpages@xxxxxxxxx>
Date: Mon, 15 Feb 2016 11:25:12 +0100
Cc: mtk.manpages@xxxxxxxxx, "J. Bruce Fields" <bfields@xxxxxxxxxxxx>, linux-ext4 <linux-ext4@xxxxxxxxxxxxxxx>, XFS Developers <xfs@xxxxxxxxxxx>, lkml <linux-kernel@xxxxxxxxxxxxxxx>, linux-fsdevel <linux-fsdevel@xxxxxxxxxxxxxxx>, Linux NFS Mailing List <linux-nfs@xxxxxxxxxxxxxxx>, linux-cifs@xxxxxxxxxxxxxxx, Linux API <linux-api@xxxxxxxxxxxxxxx>, Dave Chinner <david@xxxxxxxxxxxxx>, Christoph Hellwig <hch@xxxxxxxxxxxxx>, Anna Schumaker <anna.schumaker@xxxxxxxxxx>, Trond Myklebust <trond.myklebust@xxxxxxxxxxxxxxx>, Jeff Layton <jlayton@xxxxxxxxxxxxxxx>, Andreas Dilger <adilger@xxxxxxxxx>
Delivered-to: xfs@xxxxxxxxxxx
Dkim-signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=subject:to:references:cc:from:message-id:date:user-agent :mime-version:in-reply-to:content-type:content-transfer-encoding; bh=f6/bIpxTLca1235By2YkmiwxOZ2kQqQrtnVGeQV2CKs=; b=Hl2wPyKd2NnVWH3XCKznBPoMaO5FnFU8b4u7nG1jo5Ta/TQMrGZcXi2n+OuXedAkfT XZuoCvLzj3kr5/0eEMkyg8a0GA7U4GRGPSsCXUqX/LH+6hMHlUb36r3ZWuxankoZCyER XSRPWoyFBW687a5czTODslrz8t6gAEaERfwgVjQVFJ8C9pZ6PcT+4YhHB6o0FAy2TRa9 15LpmSO05s7/bkKLUlaDa9aPBrKTe5XSy4YInrOOqh3dMxYY5vYRBOZ5fdHdyAH8vOOi EpZIveIvb+C34HBLBku6XwQrISbNsvxKrRBtD/psuDxF5gAE5UxYL4ZSAM8xupDsF2q1 YIew==
In-reply-to: <CAHc6FU49uRb11HhO655jimn_CzLrDyGHAB2iDAv92cftCCXkEA@xxxxxxxxxxxxxx>
References: <56B770B6.7040803@xxxxxxxxx> <56B77262.7090107@xxxxxxxxx> <CAHc6FU5__xbKm4mg8+fK_ZW5ZYsDoQcYBBvQg573Eq4ERDsROw@xxxxxxxxxxxxxx> <56C0F150.60008@xxxxxxxxx> <CAHc6FU49uRb11HhO655jimn_CzLrDyGHAB2iDAv92cftCCXkEA@xxxxxxxxxxxxxx>
User-agent: Mozilla/5.0 (X11; Linux x86_64; rv:38.0) Gecko/20100101 Thunderbird/38.5.0
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)
> <mtk.manpages@xxxxxxxxx> 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/

<Prev in Thread] Current Thread [Next in Thread>