[src/trunk]: src/lib/libc Add section headings. Match order in table of cont...

[riastradh <riastradh%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/a72e73f93e3f
branches:  trunk
changeset: 809447:a72e73f93e3f
user:      riastradh <riastradh%NetBSD.org@localhost>
date:      Sat Jul 11 14:29:50 2015 +0000

description:
Add section headings.  Match order in table of contents.

diffstat:

 lib/libc/README |  14 +++++++++++---
 1 files changed, 11 insertions(+), 3 deletions(-)

diffs (49 lines):

diff -r ae8bb1be8a1f -r a72e73f93e3f lib/libc/README
--- a/lib/libc/README   Sat Jul 11 14:18:08 2015 +0000
+++ b/lib/libc/README   Sat Jul 11 14:29:50 2015 +0000
@@ -1,4 +1,4 @@
-       $NetBSD: README,v 1.3 2015/03/20 14:10:40 riastradh Exp $
+       $NetBSD: README,v 1.4 2015/07/11 14:29:50 riastradh Exp $
 
 libc: The C library.
 
@@ -8,8 +8,10 @@
 
 (a) standard library routines in C and POSIX,
 (b) published NetBSD-specific nonstandard extensions,
-(c) old versions of library routines, and
-(d) internal symbols.
+(c) internal symbols, and
+(d) old versions of any published library routines.
+
+** Standard library routines
 
 If a library routine is standard and its signature has never changed,
 it is defined as an ELF global symbol.  Its name is declared normally
@@ -19,6 +21,8 @@
    standard C memory allocator routines.  The names `malloc' and `free'
    are declared normally in <stdlib.h> (src/include/stdlib.h).
 
+** NetBSD-specific nonstandard extensions
+
 If a library routine is nonstandard but published and its signature has
 never changed, it is defined as an ELF weak symbol aliasing an ELF
 global symbol of the same name with an underscore prefix.
@@ -57,6 +61,8 @@
    to provide `consttime_memequal' as an ELF weak symbol aliasing
    `_consttime_memequal'.
 
+** Internal symbols
+
 If a library routine is internal to libc, it is defined as an ELF
 global symbol with an underscore prefix.  Its name is declared in the
 appropriate internal header file.
@@ -67,6 +73,8 @@
    src/lib/libc/gen/dirent_private.h, and defined normally in
    src/lib/libc/gen/initdir.c.
 
+** Old versions of library routines
+
 If the signature or semantics of a library routine foo changed in (for
 example) NetBSD 6.0, then libc provides