[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]
Message-ID: <78b648da-dde7-d331-7384-03214b977e6d@kernel.org>
Date: Sat, 8 Jul 2023 19:03:23 +0200
From: Alejandro Colomar <alx@...nel.org>
To: Paul Eggert <eggert@...ucla.edu>
Cc: "A. Wilcox" <AWilcox@...cox-tech.com>, libc-coord@...ts.openwall.com,
Jonathan Wakely <jwakely@...hat.com>, Rich Felker <dalias@...c.org>,
linux-man@...r.kernel.org, libc-alpha@...rceware.org,
musl@...ts.openwall.com, Sam James <sam@...too.org>,
Szabolcs Nagy <nsz@...t70.net>, Jakub Wilk <jwilk@...lk.net>
Subject: Re: [musl] Re: Re: regression in man pages for
interfaces using loff_t
Hi all,
On 7/3/23 23:35, Paul Eggert wrote:
> On 2023-07-03 11:16, Jakub Wilk wrote:
>>> -This format is employed in cases where only a single
>>> -feature test macro can be used to expose the function
>>> -declaration, and that macro is not defined by default.
>>> +This format is employed in cases where feature macros
>>> +expose the function declaration with the correct type,
>>> +and these macros are not defined by default.
>>
>> This isn't right. The shorthand format is sometimes used when there's
>> no off(64)_t involved, e.g. in memfd_create(2).
>
> Fair enough. Let's improve that wording to:
>
> This format is employed when the feature test macros ensure that the
> proper function declarations are visible, and the macros are not defined
> by default.
>
> Revised patch attached. If this wording is still not clear enough,
> please feel free to suggest better wording.
Thanks for the v3 patch, Paul. I like it. Would you mind resending it
inline, to make it easier to quote-reply to it, in case anyone wants
to discuss anything? Does anyone oppose to this patch, and wants to
propose an alternative patch?
Cheers,
Alex
--
<http://www.alejandro-colomar.es/>
GPG key fingerprint: A9348594CE31283A826FBDD8D57633D441E25BB5
Download attachment "OpenPGP_signature" of type "application/pgp-signature" (834 bytes)
Powered by blists - more mailing lists
Confused about mailing lists and their use?
Read about mailing lists on Wikipedia
and check out these
guidelines on proper formatting of your messages.
