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

[Rical Jasan]

On 11/25/2016 08:16 AM, Joseph Myers wrote:
> On Fri, 25 Nov 2016, Rical Jasan wrote:
> 
>> On 11/23/2016 09:42 AM, Joseph Myers wrote:
>>> In stdio.h, 
>>> SEEK_SET, SEEK_CUR, SEEK_END are all likewise C90.
>>
>> What about the other 2 headers?  I had:
>>
>> @comment stdio.h unistd.h fcntl.h
>> @comment ISOC99, POSIX, XOPEN || XOPEN2K8
>>
>> Do you want:
>>
>> @comment stdio.h unistd.h fcntl.h
>> @comment C90, POSIX, XOPEN || POSIX.1-2008
> 
> Well, I'd like that comment in summary.awk saying what the intended syntax 
> actually is in the case of multiple headers (how the standards are to be 
> matched to the headers).  But:

I'm not sure summary.awk does any matching, but I'd have to take a
closer look, as I wasn't watching explicitly for that.  I'll certainly
update the comment with accepted syntax, though.

> For stdio.h it's C90.
> 
> For unistd.h it's POSIX.1 (i.e. 1990 edition, in the list I gave of 
> possible notation for standards).
> 
> For fcntl.h it's XOPEN || POSIX.1-2008.
> 
> So if comma-separated standards correspond to space-separated headers, 
> it's as you say except for my proposed notation saying POSIX.1 for the 
> 1990 edition.

Would you like to see an additional patch in the set that converts
existing XOPEN2K, etc.?  I've only fixed the ones I introduced.

Rical