Re: [PATCH] manual: Document missing feature test macros.

[Joseph Myers <joseph at codesourcery dot com>]

On Thu, 27 Jul 2017, Rical Jasan wrote:

> +If you define this macro to a value greater than or equal to
> +@code{200112L}, then the functionality from the 2004 edition of the
> +POSIX standard (IEEE Standard 1003.1-2004) is made available.
> +
> +If you define this macro to a value greater than or equal to
> +@code{200809L}, then the functionality from the 2008 edition of the
> +POSIX standard (IEEE Standard 1003.1-2008) is made available.

This description is inconsistent.

Both the 2001 and 2008 editions of POSIX had subsequent corrected editions 
incorporating TCs, and the corrections are not distinguished by 
_POSIX_C_SOURCE versions (such bug-fixes to the standard are applied 
unconditionally).  But you're referencing the 2004 corrected version of 
the 2001 edition of POSIX, together with the original 2008 edition rather 
than the 2013 or 2016 bug-fix versions of it.

I think referencing the 2001 and 2008 editions rather than the subsequent 
bug-fix versions is most appropriate (if you want to say the bug-fixes are 
applied, do so separately).

>  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".

-- 
Joseph S. Myers
joseph@codesourcery.com