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

This commit is contained in:
Michael Kerrisk 2010-10-04 05:08:49 +02:00
parent a5f0b77d70
commit c04efb3af7
2 changed files with 277 additions and 241 deletions

243
Changes
View File

@ -1,6 +1,6 @@
==================== Changes in man-pages-3.28 ====================
==================== Changes in man-pages-3.29 ====================
Released: 2010-10-04, Munich
Released: ????-??-??, Munich
Contributors
@ -9,15 +9,6 @@ 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!
@ -25,249 +16,19 @@ 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"

View File

@ -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"