[PATCH 3/3] manual: Add new header and standards annotations.
Florian Weimer
fweimer@redhat.com
Wed Nov 30 10:45:00 GMT 2016
On 11/30/2016 11:39 AM, Rical Jasan wrote:
> On 11/25/2016 06:53 AM, Joseph Myers wrote:
>> Where the function description would then have:
>>
>> Preliminary: | MT-Safe | AS-Safe | AC-Safe | *Note POSIX Safety
>> Concepts::.
>>
>> Standards: POSIX.1-2008 (unistd.h). *Note Feature Test Macros::.
>
> I like this. This is one of the avenues I was going to suggest, though
> I wasn't sure how amenable everybody would be to more boilerplate in
> *every single* description.
Many programmers would also find annotations which glibc version
introduced a particular functionality *extremely* useful, especially for
functions that were added after glibc 2.5 or so. It's not a standard as
such (but LSB would be), but I think it serves a similar purpose.
Can we reconsider adding this kind of information to the manual?
Thanks,
Florian
More information about the Libc-alpha
mailing list