This is the mail archive of the libc-alpha@sourceware.org mailing list for the glibc project.

Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

Re: [PATCH 3/3] manual: Add new header and standards annotations.

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
Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]