linux-man.vger.kernel.org archive mirror
 help / color / mirror / Atom feed
From: "Michael Kerrisk (man-pages)" <mtk.manpages-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>
To: "Andreas Grünbacher" <agruen-mXXj517/zsQ@public.gmane.org>
Cc: mtk.manpages-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org,
	"linux-man-u79uwXL29TY76Z2rM5mHXA@public.gmane.org"
	<linux-man-u79uwXL29TY76Z2rM5mHXA@public.gmane.org>,
	acl-devel-qX2TKyscuCcdnm+yROfE0A@public.gmane.org
Subject: Re: [Acl-devel] Moving attr(5) man page to man-pages
Date: Wed, 22 Apr 2015 15:03:55 +0200	[thread overview]
Message-ID: <55379C3B.4030100@gmail.com> (raw)
In-Reply-To: <CAHpGcMLQPmz3-Wh3oRbx=pqdJDr6GHmRqbfR3vEedfZajFZ1nQ-JsoAwUIsXosN+BqQ9rBEUg@public.gmane.org>

Hi Andreas,

On 04/22/2015 02:16 PM, Andreas Grünbacher wrote:
> 2015-04-22 13:58 GMT+02:00 Michael Kerrisk (man-pages) <mtk.manpages@gmail.com>:
>>>> I've made a number of edits to the page. Some of these were just
>>>> to bring the page closer to man-pages style,
>>>
>>> The \(em dashes don't render in terminals very well.
>>
>> What's the problem? (Many existing pages use \(em dashes
>> so this change was just for consistency.)
> 
> It's just ugly; there isn't a big difference between a hyphen and an em-dash.
> 
>>> In addition, I would remove the list of file systems with extended
>>> attribute support; they are supported pretty much everywhere to some
>>> degree at least, even on  tmpfs.
>>
>> Fair enough. I see your patch does that.
>>
>>> I'm attaching a patch that also includes a few other minor changes.
>>
>> Thanks! Applied.
>>
>> By the way, the piece
>>
>>     The list of attribute names that can be returned is also
>>     limited to 64 kB.
>>
>> Is a limitation that affects listxattr(2), right? Maybe I should add
>> a sentence on that point to that page.
> 
> Yes, thanks.
> 
>> Also, what does this mean is someone (tries to) create(s) more than
>> 64 kB of attribute names on a file? Do you get an error on setxattr(),
>> or is it the case that some names are unretrievable?
>>
>> Hmm... some light testing (using XFS) suggests that one can create
>> more than 64 kB of attribute names, but then listxattr() fails
>> with E2BIG. That seems like a sad corner case :-(.
> 
> That's what will happen, yes. I don't have a good idea how to fix this.

:-(. Okay, I've documented that error in listxattr(2) and added
a BUGS section pointing out that corner case.

Thanks,

Michael

-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

      parent reply	other threads:[~2015-04-22 13:03 UTC|newest]

Thread overview: 11+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2015-04-22  8:55 Moving attr(5) man page to man-pages Michael Kerrisk (man-pages)
     [not found] ` <5537620E.3000601-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>
2015-04-22 10:13   ` [Acl-devel] " Andreas Grünbacher
2015-04-22 10:21   ` Christoph Hellwig
     [not found]     ` <20150422102128.GA24625-wEGCiKHe2LqWVfeAwA7xHQ@public.gmane.org>
2015-04-22 11:36       ` Michael Kerrisk (man-pages)
     [not found]         ` <553787D8.602-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>
2015-04-22 12:12           ` Andreas Grünbacher
     [not found]             ` <CAHpGcMLgpvMEs1x59cwQ3UGGUFks5F5m2WYLsgSGUodsL4ue5Q-JsoAwUIsXosN+BqQ9rBEUg@public.gmane.org>
2015-04-22 12:34               ` Michael Kerrisk (man-pages)
2015-04-22 10:42   ` Andreas Grünbacher
     [not found]     ` <CAHpGcM+OcP1=z6KmcfqQX2L7TcFyQuQaNHphMim77zNQ_5TqYQ-JsoAwUIsXosN+BqQ9rBEUg@public.gmane.org>
2015-04-22 11:58       ` Michael Kerrisk (man-pages)
     [not found]         ` <55378CD2.7060408-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>
2015-04-22 12:16           ` Andreas Grünbacher
     [not found]             ` <CAHpGcMLQPmz3-Wh3oRbx=pqdJDr6GHmRqbfR3vEedfZajFZ1nQ-JsoAwUIsXosN+BqQ9rBEUg@public.gmane.org>
2015-04-22 12:19               ` Christoph Hellwig
2015-04-22 13:03               ` Michael Kerrisk (man-pages) [this message]

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=55379C3B.4030100@gmail.com \
    --to=mtk.manpages-re5jqeeqqe8avxtiumwx3w@public.gmane.org \
    --cc=acl-devel-qX2TKyscuCcdnm+yROfE0A@public.gmane.org \
    --cc=agruen-mXXj517/zsQ@public.gmane.org \
    --cc=linux-man-u79uwXL29TY76Z2rM5mHXA@public.gmane.org \
    /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 a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).