[PATCH v2 3/5] manual: Add new header and standards annotations.
Rical Jasan
ricaljasan@pacific.net
Tue Dec 6 10:56:00 GMT 2016
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 a standard derived from any feature test macros
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 uses a loose convention
of standard names, though the syntax is essentially free-form.
It prefers names that indicate specific standards and the
oldest relevant standard, where known (e.g., "C90" over "ISO"
or "POSIX.1-2001" over "POSIX").
* 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/startup.texi: Likewise.
* manual/stdio.texi: Likewise.
* manual/string.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: 83327 bytes
Desc: not available
URL: <http://sourceware.org/pipermail/libc-alpha/attachments/20161206/7f3b0119/attachment.bin>
More information about the Libc-alpha
mailing list