Start of man-pages-3.29: updating Changes and Changes.old

1 files changed, 275 insertions, 0 deletions

diff --git a/Changes.old b/Changes.old
index 171571f9c..84370769f 100644
--- a/Changes.old
+++ b/Changes.old
@@ -20548,3 +20548,278 @@ tcp.7
     Michael Kerrisk
         Clarify header file details for SIOCINQ and SIOCOUTQ
             Also note synonymous FIONREAD and TIOCOUTQ.
+
+
+==================== Changes in man-pages-3.28 ====================
+
+Released: 2010-10-04, Munich
+
+
+Contributors
+------------
+
+The following people contributed notes, ideas, or patches that have
+been incorporated in changes in this release:
+
+Andries E. Brouwer <Andries.Brouwer@cwi.nl>
+Denis Barbier <bouzim@gmail.com>
+Jan Kara <jack@suse.cz>
+Landijk <landijk-user@yahoo.com>
+Lennart Poettering <mzjro@0pointer.net>
+Michael Haardt <michael@moria.de>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Petr Baudis <pasky@suse.cz>
+Sam Varshavchik <mrsam@courier-mta.com>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+getaddrinfo_a.3
+    Petr Baudis
+        New page documenting getaddrinfo_a()
+            The page also documents gai_suspend(), gai_cancel(),
+            and gai_error().
+
+aio.7
+    Michael Kerrisk
+        New page providing an overview of POSIX asynchronous I/O
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+exec.3
+    Michael Kerrisk
+        Document execpe()
+            This function was added to glibc in version 2.11.
+            Also various other small rewrites in the page.
+
+
+New and changed links
+---------------------
+
+gai_cancel.3
+gai_error.3
+gai_suspend.3
+    Petr Baudis
+        New links to new getaddrinfo_a.3 page
+
+error_one_per_line.3
+    Michael Kerrisk
+         Fix misnamed link file (was error_on_per_line.3)
+
+execvpe.3
+    Michael Kerrisk
+        New link to exec.3
+
+sigstack.3
+    Michael Kerrisk
+        New link to sigaltstack.2
+            No new programs should use sigstack(3). Point the user to the
+            better sigalstack(2), whose man page briefly mentions sigstack(3).
+
+vlimit.3
+    Michael Kerrisk
+        New link to getrlimit.2
+            No new programs should use vlimit(3). Point the user to the
+            better setrlimit(2), whose man page briefly mentions vlimit(3).
+
+vtimes.3
+    Michael Kerrisk
+        New link to getrusage.2
+            No new programs should use vtimes(3). Point the user to the
+            better getrusage(2), whose man page briefly mentions vtimes(3).
+
+
+Global changes
+--------------
+
+Various pages
+    Michael Kerrisk
+        Switch to American usage: "-wards" ==> "-ward"
+            American English uses "afterward" in preference to "afterwards",
+            and so on
+
+chdir.2
+chmod.2
+chown.2
+gethostname.2
+getsid.2
+pread.2
+setpgid.2
+sigaltstack.2
+stat.2
+truncate.2
+wait.2
+dirfd.3
+getsubopt.3
+mkdtemp.3
+mkstemp.3
+siginterrupt.3
+strdup.3
+    Michael Kerrisk
+        Simplify feature test macro requirements
+
+
+Changes to individual pages
+---------------------------
+
+getrlimit.2
+    Michael Kerrisk
+        Add mention of the ancient vlimit() function
+
+getrusage.2
+    Michael Kerrisk
+        Add mention of the ancient vtimes() function
+
+io_cancel.2
+io_destroy.2
+io_getevents.2
+io_setup.2
+io_submit.2
+    Michael Kerrisk
+        SEE ALSO: add aio(7)
+
+sched_setscheduler.2
+    Michael Kerrisk
+        ERRORS: note that NULL 'param' yields EINVAL
+
+stat.2
+    Michael Kerrisk
+        Note feature test macro requirements for blkcnt_t and blksize_t
+
+timer_create.2
+    Michael Kerrisk
+        Standardize on name 'sevp' for sigevent argument
+
+truncate.2
+    Michael Kerrisk
+        Correct and simplify ftruncate() feature test macro requirements
+            The glibc 2.12 feature test macro requirements for ftruncate() are
+            buggy; see http://sourceware.org/bugzilla/show_bug.cgi?id=12037.
+            Corrected the requirements in the SYNOPSIS, and added a BUGS
+            section describing the problem in glibc 2.12.
+
+aio_cancel.3
+    Michael Kerrisk
+        Add pointer to aio(7) for example program
+        Refer the reader to aio(7) for a description of the aiocb structure
+        CONFORMING TO: Add POSIX.1-2008; add VERSIONS section
+
+aio_error.3
+    Michael Kerrisk
+        Wording improvements in RETURN VALUE
+        Add pointer to aio(7) for example program
+        Refer the reader to aio(7) for a description of the aiocb structure
+        CONFORMING TO: Add POSIX.1-2008; add VERSIONS section
+
+aio_fsync.3
+    Michael Kerrisk
+        Refer the reader to aio(7) for a description of the aiocb structure
+        CONFORMING TO: Add POSIX.1-2008; add VERSIONS section
+
+aio_read.3
+    Michael Kerrisk
+        Various minor rewordings and additions
+        Add pointer to sigevent(7) for details of notification of I/O completion
+        Add pointer to aio(7) for example program
+        Refer the reader to aio(7) for a description of the aiocb structure
+        CONFORMING TO: Add POSIX.1-2008; add VERSIONS section
+
+aio_return.3
+    Michael Kerrisk
+        Improve description in RETURN VALUE
+        Add pointer to aio(7) for example program
+        Refer the reader to aio(7) for a description of the aiocb structure
+        CONFORMING TO: Add POSIX.1-2008; add VERSIONS section
+
+aio_suspend.3
+    Michael Kerrisk
+        Various additions and rewordings.
+            Give some arguments more meaningful names.
+            More explicitly describe the 'nitems' argument.
+            Explicitly note that return is immediate if an I/O operation
+            has already completed.
+            Note that aio_error(3) should be used to scan the aiocb list
+            after a successful return.
+            Add references to other relevant pages.
+            Various other pieces rewritten.
+        Refer the reader to aio(7) for a description of the aiocb structure
+        CONFORMING TO: Add POSIX.1-2008; add VERSIONS section
+
+aio_write.3
+    Michael Kerrisk
+        Add pointer to sigevent(7) for details of notification of I/O completion
+        Various minor rewordings and additions
+        Refer the reader to aio(7) for a description of the aiocb structure
+        CONFORMING TO: Add POSIX.1-2008; add VERSIONS section
+
+clearenv.3
+    Michael Kerrisk
+        Fix error in feature test macro requirements
+
+dysize.3
+    Michael Kerrisk
+        Remove crufty statement about old SCO bug
+
+exec.3
+    Michael Kerrisk
+        Add feature test macro requirements for execvpe()
+        Rewrite description of PATH and mention _CS_PATH
+        Note execvp() and execlp() behavior for filename containing a slash
+
+getaddrinfo.3
+    Michael Kerrisk
+        Add SEE ALSO reference to new getaddrinfo_a.3 page
+
+gethostbyname.3
+    Michael Kerrisk
+        Fix formatting of feature test macros
+
+getw.3
+    Michael Kerrisk
+        Fix feature test macros
+
+malloc.3
+    Landijk
+        Remove editorializing comments on memory overcommitting
+            See https://bugzilla.kernel.org/show_bug.cgi?id=19332
+    Michael Kerrisk
+        Various minor reorganizations and wording fix-ups
+
+mq_notify.3
+    Michael Kerrisk
+        Standardize on name 'sevp' for sigevent argument
+
+nl_langinfo.3
+    Michael Haardt
+        Make it clear that nl_langinfo() interacts with setlocale()
+        Add an example program
+
+posix_openpt.3
+    Michael Kerrisk
+        Fix feature test macro requirements
+
+rand.3
+    Michael Kerrisk
+        Remove duplicate #include in example program
+
+strtok.3
+    Petr Baudis
+        Add reference to strtok() example in getaddrinfo(3)
+
+inotify.7
+    Michael Kerrisk
+        Added section noting limitations and caveats of inotify
+
+sigevent.7
+    Michael Kerrisk
+        Add SEE ALSO reference to new getaddrinfo_a.3 page
+        Add SEE ALSO referring to new aio(7) page
+
+suffixes.7
+    Michael Kerrisk
+        Change explanation of ".rpm" to "RPM software package"