All of lore.kernel.org
 help / color / mirror / Atom feed
From: "Michael Kerrisk (man-pages)" <mtk.manpages@gmail.com>
To: Andreas Gruenbacher <agruenba@redhat.com>
Cc: mtk.manpages@gmail.com, "J. Bruce Fields" <bfields@fieldses.org>,
	linux-ext4 <linux-ext4@vger.kernel.org>,
	XFS Developers <xfs@oss.sgi.com>,
	lkml <linux-kernel@vger.kernel.org>,
	linux-fsdevel <linux-fsdevel@vger.kernel.org>,
	Linux NFS Mailing List <linux-nfs@vger.kernel.org>,
	linux-cifs@vger.kernel.org, Linux API <linux-api@vger.kernel.org>,
	Dave Chinner <david@fromorbit.com>,
	Christoph Hellwig <hch@infradead.org>,
	Anna Schumaker <anna.schumaker@netapp.com>,
	Trond Myklebust <trond.myklebust@primarydata.com>,
	Jeff Layton <jlayton@poochiereds.net>,
	Andreas Dilger <adilger@dilger.ca>
Subject: Re: richacl(7) man page review comments
Date: Mon, 15 Feb 2016 11:25:12 +0100	[thread overview]
Message-ID: <56C1A788.9020008@gmail.com> (raw)
In-Reply-To: <CAHc6FU49uRb11HhO655jimn_CzLrDyGHAB2iDAv92cftCCXkEA@mail.gmail.com>

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@gmail.com> 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/

WARNING: multiple messages have this Message-ID (diff)
From: "Michael Kerrisk (man-pages)" <mtk.manpages@gmail.com>
To: Andreas Gruenbacher <agruenba@redhat.com>
Cc: Andreas Dilger <adilger@dilger.ca>,
	linux-cifs@vger.kernel.org,
	Linux NFS Mailing List <linux-nfs@vger.kernel.org>,
	Christoph Hellwig <hch@infradead.org>,
	Linux API <linux-api@vger.kernel.org>,
	Trond Myklebust <trond.myklebust@primarydata.com>,
	lkml <linux-kernel@vger.kernel.org>,
	XFS Developers <xfs@oss.sgi.com>,
	"J. Bruce Fields" <bfields@fieldses.org>,
	mtk.manpages@gmail.com,
	linux-fsdevel <linux-fsdevel@vger.kernel.org>,
	Jeff Layton <jlayton@poochiereds.net>,
	linux-ext4 <linux-ext4@vger.kernel.org>,
	Anna Schumaker <anna.schumaker@netapp.com>
Subject: Re: richacl(7) man page review comments
Date: Mon, 15 Feb 2016 11:25:12 +0100	[thread overview]
Message-ID: <56C1A788.9020008@gmail.com> (raw)
In-Reply-To: <CAHc6FU49uRb11HhO655jimn_CzLrDyGHAB2iDAv92cftCCXkEA@mail.gmail.com>

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@gmail.com> 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/

_______________________________________________
xfs mailing list
xfs@oss.sgi.com
http://oss.sgi.com/mailman/listinfo/xfs

  reply	other threads:[~2016-02-15 10:25 UTC|newest]

Thread overview: 74+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2016-02-07 16:28 RichACLs man-pages review Michael Kerrisk (man-pages)
2016-02-07 16:28 ` Michael Kerrisk (man-pages)
     [not found] ` <56B770B6.7040803-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>
2016-02-07 16:29   ` Michael Kerrisk (man-pages)
2016-02-07 16:29     ` Michael Kerrisk (man-pages)
2016-02-07 16:29     ` Michael Kerrisk (man-pages)
2016-02-07 16:30   ` getrichacl(1) man page review comments Michael Kerrisk (man-pages)
2016-02-07 16:30     ` Michael Kerrisk (man-pages)
2016-02-07 16:30     ` Michael Kerrisk (man-pages)
2016-02-07 18:16     ` Martin Steigerwald
2016-02-07 18:16       ` Martin Steigerwald
     [not found]     ` <56B77139.4080209-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>
2016-02-14 21:30       ` Michael Kerrisk (man-pages)
2016-02-14 21:30         ` Michael Kerrisk (man-pages)
2016-02-14 21:30         ` Michael Kerrisk (man-pages)
2016-02-07 16:31   ` setrichacl(1) " Michael Kerrisk (man-pages)
2016-02-07 16:31     ` Michael Kerrisk (man-pages)
2016-02-07 16:31     ` Michael Kerrisk (man-pages)
2016-02-14 21:29     ` Michael Kerrisk (man-pages)
2016-02-14 21:29       ` Michael Kerrisk (man-pages)
2016-02-07 16:35   ` richacl(7) " Michael Kerrisk (man-pages)
2016-02-07 16:35     ` Michael Kerrisk (man-pages)
2016-02-07 16:35     ` Michael Kerrisk (man-pages)
     [not found]     ` <56B77262.7090107-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>
2016-02-10 19:34       ` J. Bruce Fields
2016-02-10 19:34         ` J. Bruce Fields
2016-02-10 19:34         ` J. Bruce Fields
2016-02-12 22:25     ` Andreas Gruenbacher
2016-02-12 22:25       ` Andreas Gruenbacher
2016-02-12 22:25       ` Andreas Gruenbacher
     [not found]       ` <CAHc6FU5__xbKm4mg8+fK_ZW5ZYsDoQcYBBvQg573Eq4ERDsROw-JsoAwUIsXosN+BqQ9rBEUg@public.gmane.org>
2016-02-14 21:27         ` Michael Kerrisk (man-pages)
2016-02-14 21:27           ` Michael Kerrisk (man-pages)
2016-02-14 21:27           ` Michael Kerrisk (man-pages)
2016-02-14 23:12           ` Andreas Gruenbacher
2016-02-14 23:12             ` Andreas Gruenbacher
2016-02-15 10:25             ` Michael Kerrisk (man-pages) [this message]
2016-02-15 10:25               ` Michael Kerrisk (man-pages)
     [not found]               ` <56C1A788.9020008-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>
2016-02-15 11:35                 ` Andreas Gruenbacher
2016-02-15 11:35                   ` Andreas Gruenbacher
2016-02-15 11:35                   ` Andreas Gruenbacher
     [not found]                   ` <CAHc6FU69k2uRXjSSS+9K0cXzFs74DPsz6DDv8GN=hmh7RpPA-Q-JsoAwUIsXosN+BqQ9rBEUg@public.gmane.org>
2016-02-15 14:15                     ` Michael Kerrisk (man-pages)
2016-02-15 14:15                       ` Michael Kerrisk (man-pages)
2016-02-15 14:15                       ` Michael Kerrisk (man-pages)
2016-02-14 21:31         ` Michael Kerrisk (man-pages)
2016-02-14 21:31           ` Michael Kerrisk (man-pages)
2016-02-14 21:31           ` Michael Kerrisk (man-pages)
     [not found]           ` <56C0F23C.7030902-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>
2016-02-20 16:37             ` Andreas Gruenbacher
2016-02-20 16:37               ` Andreas Gruenbacher
2016-02-20 16:37               ` Andreas Gruenbacher
     [not found]               ` <CAHc6FU4CCrcrA6=oCiq2A5rGd9CCGELaTZq6tGpmd2jcV_Zp4A-JsoAwUIsXosN+BqQ9rBEUg@public.gmane.org>
2016-02-21 21:01                 ` Michael Kerrisk (man-pages)
2016-02-21 21:01                   ` Michael Kerrisk (man-pages)
2016-02-21 21:01                   ` Michael Kerrisk (man-pages)
2016-02-21 21:40                 ` Michael Kerrisk (man-pages)
2016-02-21 21:40                   ` Michael Kerrisk (man-pages)
2016-02-21 21:40                   ` Michael Kerrisk (man-pages)
     [not found]                   ` <56CA2EEB.9080504-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>
2016-02-22 14:46                     ` Andreas Gruenbacher
2016-02-22 14:46                       ` Andreas Gruenbacher
2016-02-22 14:46                       ` Andreas Gruenbacher
2016-02-23 10:16                       ` Michael Kerrisk (man-pages)
2016-02-23 10:16                         ` Michael Kerrisk (man-pages)
     [not found]                         ` <56CC3174.2060207-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>
2016-02-23 10:28                           ` Andreas Gruenbacher
2016-02-23 10:28                             ` Andreas Gruenbacher
2016-02-23 10:28                             ` Andreas Gruenbacher
2016-02-28 22:11                           ` Andreas Gruenbacher
2016-02-28 22:11                             ` Andreas Gruenbacher
2016-02-28 22:11                             ` Andreas Gruenbacher
2016-02-23 10:58                       ` Michael Kerrisk (man-pages)
2016-02-23 10:58                         ` Michael Kerrisk (man-pages)
2016-02-23 10:58                         ` Michael Kerrisk (man-pages)
2016-02-23 11:14                         ` Andreas Gruenbacher
2016-02-23 11:14                           ` Andreas Gruenbacher
     [not found]                         ` <56CC3B4A.7070204-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>
2016-02-23 15:09                           ` Andreas Gruenbacher
2016-02-23 15:09                             ` Andreas Gruenbacher
2016-02-23 15:09                             ` Andreas Gruenbacher
     [not found]                             ` <CAHc6FU67LnV7-roofFe1y_uTfvgwonRZimyu7Wn1CDRzwHZJSw-JsoAwUIsXosN+BqQ9rBEUg@public.gmane.org>
2016-02-23 19:01                               ` Andreas Gruenbacher
2016-02-23 19:01                                 ` Andreas Gruenbacher
2016-02-23 19:01                                 ` Andreas Gruenbacher

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=56C1A788.9020008@gmail.com \
    --to=mtk.manpages@gmail.com \
    --cc=adilger@dilger.ca \
    --cc=agruenba@redhat.com \
    --cc=anna.schumaker@netapp.com \
    --cc=bfields@fieldses.org \
    --cc=david@fromorbit.com \
    --cc=hch@infradead.org \
    --cc=jlayton@poochiereds.net \
    --cc=linux-api@vger.kernel.org \
    --cc=linux-cifs@vger.kernel.org \
    --cc=linux-ext4@vger.kernel.org \
    --cc=linux-fsdevel@vger.kernel.org \
    --cc=linux-kernel@vger.kernel.org \
    --cc=linux-nfs@vger.kernel.org \
    --cc=trond.myklebust@primarydata.com \
    --cc=xfs@oss.sgi.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.