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] Add "Inter-process Communication" chapter to the glibc manual.


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

> +The @glibcadj{} implements the semaphore APIs as defined in POSIX and

You mean @Theglibc{}, this is a noun use rather than an adjective use.

-- 
Joseph S. Myers
joseph@codesourcery.com


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]