[PATCH 3/3] manual: Add new header and standards annotations.
Rical Jasan
ricaljasan@pacific.net
Wed Nov 23 06:38:00 GMT 2016
manual: Add new header and standards annotations.
This commit completes header and standard annotations for all
@def*-commands and @vtable @items.
The header annotations are believed to all be correct, as the
various definitions/declarations had to found in a header.
The standards annotations are a best-effort. They are roughly
derived from the following strategy:
1) Use the feature test macro if wrapped in a #if.
2) Obvious context, including:
a) top of file says, e.g., "ISO C99 ..."
b) manual annotates other nearby, related entries
c) manual describes section as per a given standard
The "???" placeholder is used for anything not obvious from a
cursory survey of the glibc sources.
The choice of standards nomenclature is not meant to establish
any sort of convention.
In the Summary of Library Facilities, this commit adds roughly
380 new entries, and fixes a few others.
* manual/argp.texi: Complete header and standards annotations.
* manual/arith.texi: Likewise.
* manual/creature.texi: Likewise.
* manual/filesys.texi: Likewise.
* manual/ipc.texi: Likewise.
* manual/lang.texi: Likewise.
* manual/llio.texi: Likewise.
* manual/locale.texi: Likewise.
* manual/math.texi: Likewise.
* manual/memory.texi: Likewise.
* manual/message.texi: Likewise.
* manual/nss.texi: Likewise.
* manual/pattern.texi: Likewise.
* manual/platform.texi: Likewise.
* manual/process.texi: Likewise.
* manual/resource.texi: Likewise.
* manual/search.texi: Likewise.
* manual/signal.texi: Likewise.
* manual/socket.texi: Likewise.
* manual/stdio.texi: Likewise.
* manual/sysinfo.texi: Likewise.
* manual/syslog.texi: Likewise.
* manual/terminal.texi: Likewise.
* manual/time.texi: Likewise.
* manual/users.texi: Likewise.
---
manual/argp.texi | 28 +++++++++
manual/arith.texi | 28 +++++++++
manual/creature.texi | 2 +
manual/filesys.texi | 44 ++++++++++++++
manual/ipc.texi | 28 +++++++++
manual/lang.texi | 20 +++++++
manual/llio.texi | 82 +++++++++++++++++++++++++
manual/locale.texi | 166 +++++++++++++++++++++++++++++++++++++++++++++++++++
manual/math.texi | 26 ++++++++
manual/memory.texi | 25 ++++++++
manual/message.texi | 4 ++
manual/nss.texi | 8 +++
manual/pattern.texi | 36 +++++++++++
manual/platform.texi | 20 +++++++
manual/process.texi | 8 +++
manual/resource.texi | 27 +++++++++
manual/search.texi | 12 ++++
manual/signal.texi | 12 ++++
manual/socket.texi | 3 +
manual/startup.texi | 2 +
manual/stdio.texi | 52 ++++++++++++++++
manual/string.texi | 2 +
manual/sysinfo.texi | 50 ++++++++++++++++
manual/syslog.texi | 64 ++++++++++++++++++++
manual/terminal.texi | 14 +++++
manual/time.texi | 6 ++
manual/users.texi | 8 +++
27 files changed, 777 insertions(+)
-------------- next part --------------
A non-text attachment was scrubbed...
Name: 0003-manual-Add-new-header-and-standards-annotations.patch
Type: text/x-patch
Size: 83338 bytes
Desc: not available
URL: <http://sourceware.org/pipermail/libc-alpha/attachments/20161123/38336e80/attachment.bin>
More information about the Libc-alpha
mailing list