This is the mail archive of the
libc-alpha@sourceware.org
mailing list for the glibc project.
Re: [PATCH] manual: Document missing feature test macros.
- From: "Michael Kerrisk (man-pages)" <mtk dot manpages at gmail dot com>
- To: Joseph Myers <joseph at codesourcery dot com>, Rical Jasan <ricaljasan at pacific dot net>
- Cc: mtk dot manpages at gmail dot com, libc-alpha <libc-alpha at sourceware dot org>, Zack Weinberg <zackw at panix dot com>, Carlos O'Donell <carlos at redhat dot com>
- Date: Tue, 15 Aug 2017 20:41:28 +0200
- Subject: Re: [PATCH] manual: Document missing feature test macros.
- Authentication-results: sourceware.org; auth=none
- References: <20170727093729.30796-1-ricaljasan@pacific.net> <alpine.DEB.2.20.1707280035060.1103@digraph.polyomino.org.uk>
On 07/28/2017 02:38 AM, Joseph Myers wrote:
> On Thu, 27 Jul 2017, Rical Jasan wrote:
[...]
>> If the macro @code{_XOPEN_SOURCE} has the value @math{500} this includes
>> all functionality described so far plus some new definitions from the
>> -Single Unix Specification, @w{version 2}.
>> +Single Unix Specification, @w{version 2}. The value @math{600} will
>> +include definitions from the sixth revision, and @math{700} will
>> +include definitions from the seventh revision.
>> @end defvr
>
> I think this should be "includes" as for the value 500, not "will
> include".
Also, this text is inconsistent. On the one hand, it talks about SUSv2,
then it talks about the "sixth revision" and the "seventh revision",
without explaining what those terms mean. Best to rewrite using
"Single Unix Specification, @w{version 3}" and
"Single Unix Specification, @w{version 4}", I'd say.
Cheers,
Michael
--
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/