[PATCH] Add "Inter-process Communication" chapter to the glibc manual.

[Carlos O'Donell]

On 02/26/2014 12:54 PM, Joseph S. Myers wrote:
> On Tue, 25 Feb 2014, Carlos O'Donell wrote:
> 
>> The functions include only their signature and safety information
>> (as audited by me). We still need to fill in the details for the
>> functions, but this is better than nothing IMO.
> 
> Do we have a good way to list functions with only signature and safety 
> documentation?  (Like scripts/documented.sh, albeit very out of date, was 
> supposed to provide for listing functions not documented at all.  It's 
> useful to be able to get a list of public interfaces not documented at 
> all, to add such interfaces to the manual as placeholders for safety 
> information, and to get a list of interfaces still needing substantive 
> documentation - that way you have two separate incremental projects, 
> putting in the placeholders and putting more substantive documentation 
> there.)

I have no automated way to do that today.

It would be a good idea to do so, perhaps based on the ABI symbol information?

What do you think is the best way to avoid parsing the headers?
 
>> +The @glibcadj{} implements the semaphore APIs as defined in POSIX and
> 
> You mean @Theglibc{}, this is a noun use rather than an adjective use.

Thanks. Fixed.

Cheers,
Carlos.