Ready for 2.33 release.

This commit is contained in:
Michael Kerrisk 2006-05-23 03:57:44 +00:00
parent a319f32dd2
commit 6c0aabc576
3 changed files with 268 additions and 95 deletions

211
Changes
View File

@ -1,6 +1,6 @@
==================== Changes in man-pages-2.32 ====================
==================== Changes in man-pages-2.33 ====================
Released: 2006-05-13
Released: 2006-05-23
Contributors
------------
@ -9,113 +9,162 @@ The following people contributed notes, ideas, or patches that have
been incorporated in changes in this release:
Andries Brouwer <Andries.Brouwer@cwi.nl>
Johannes Weiner <root@hnaz.ath.cx>
Justin Pryzby <justinpryzby@users.sourceforge.net>
Karel Kulhavy <clock@twibright.com>
Paul Brook <paul@nowt.org>
Pavel Heimlich <tropikhajma@seznam.cz>
Martin Osvald" <martin.osvald@gmail.com>
Stefan Puiu <stefanpuiuro@yahoo.com>
Apologies if I missed anyone!
Page renamings
--------------
ftm.7 renamed to the more suggestive feature_test_macros.7
mtk / Stefan Puiu
New pages
---------
faccessat.2
mtk
New page for faccessat(2), new in 2.6.16.
mq_getsetattr.2
mtk
New page briefly describing mq_getsetattr(2), the system
call that underlies mq_setattr(3) and mq_getattr(3).
fchmodat.2
CPU_ISSET.3
CPU_CLR.3
CPU_SET.3
CPU_ZERO.3
mtk
New page for fchmodat(2), new in 2.6.16.
New links to sched_setaffinity.2
fchownat.2
FD_CLR.3
FD_ISSET.3
FD_SET.3
FD_ZERO.3
mtk
New page for fchownat(2), new in 2.6.16.
New links to select.2.
futimesat.2
mq_setattr.3
mtk
New page for futimesat(2), new in 2.6.16.
New link to mq_getattr.3.
mq_timedreceive.3
mtk
New link to mq_receive.3.
mq_timedsend.3
mtk
New link to mq_send.3.
rpmatch.3
Justin Pryzby / mtk
New page for rpmatch(3).
sigandset.3
sigisemptyset.3
sigorset.3
mtk
New links to sigsetops.3.
strchrnul.3
mtk
New link to strchr.3.
Changes to individual pages
---------------------------
access.2
mtk
Add SEE ALSO reference pointing to new faccessat.2 page.
capget.2
mtk
Reworded to reflect that capabilities are per-thread.
chmod.2
mtk
Add SEE ALSO reference pointing to new fchmodat.2 page.
Remove mention of non-standard S_IREAD, S_IWRITE, S_IEXEC.
POSIX does now document ELOOP.
chown.2
open.2
mtk
Add SEE ALSO reference pointing to new fchownat.2 page.
Remove mention of non-standard S_IREAD, S_IWRITE, S_IEXEC.
mmap.2
mtk
Updated discussion of MAP_NORESERVE since it is no longer
restricted to MAP_PRIVATE mappings.
Add reference to discussion of /proc/sys/vm/overcommit_memory
in proc.5.
openat.2
mtk
Add SEE ALSO reference pointing to new faccessat.2, fchmodat.2,
fchownat.2, futimesat.2 pages.
shmget.2
mtk
Document SHM_NORESERVE flag, new in 2.6.15.
truncate.2
Paul Brook / mtk
Expand text noting that ftruncate()/truncate() may fail if
asked to extend a file beyond its current length.
Add EPERM error.
Justin Pryzby
Add mincore(2) to SEE ALSO.
See Debian bug 367401.
utime.2
msync.2
Justin Pryzby
Note that EINVAL can also be caused by
flags == MS_SYNC | MS_ASYNC.
sched_setaffinity.2
mtk
Add SEE ALSO reference pointing to new futimesat.2 page.
Add CPU_ISSET, CPU_CLR, CPU_SET, CPU_ZERO to NAME section.
fopen.3
select.2
mtk
Various minor changes.
select_tut.2
mtk
Removed much material that is redundant with select.2.
Various other changes.
umask.2
mtk
Substantial rewrite of description of 'mask'.
fts.3
Justin Pryzby
Add SEE also referring to ftw.3.
ftw.3
Justin Pryzby
Add SEE also referring to fts.3.
getline.3
Justin Pryzby
Various minor clarifications.
mkstemp.3
mtk
Clarify that O_EXCL is an open(2) flag.
mq_open.3
Martin Osvald
Fix prototype declaration for 'attr'.
mq_notify.3
Martin Osvald
s/sigev_signal/sigev_signo/
setlocale.3
Justin Pryzby
Added SEE ALSO referring to rpmatch.3.
stdio.3
Justin Pryzby
Added SEE ALSO referring to unlocked_stdio.3
See Debian bug 367667.
strchr.3
Justin Pryzby
Add description of strchrnul().
undocumented.3
Justin Pryzby / mtk
Document 'm' (mmap) flag.
Debian bug 365754.
mtk
Document 'c' (notcancel) flag.
futimes.3
mtk
Add SEE ALSO reference pointing to new futimesat.2 page.
qsort.3
Johannes Weiner
Add missing "const" qualifies to cast in EXAMPLE.
mtk
Slight rewording of comments in EXAMPLE.
termios.3
Karel Kulhavy
Clarify meaning of IXANY.
Clarify relationship of MIN with VMIN and TIME with VTIME.
mtk
Noted that CIBAUD, OFDEL, and DELECHO are not implemented
on Linux.
Added explanatory paragraph for phrases "not in POSIX" and
"XSI".
Updated to remove some functions that don't exist, and
therefore don't need to be documented.
See Debian bug 367671.
capabilities.7
unlocked_stdio.3
Justin Pryzby
Added SEE ALSO referring to stdio.3
See Debian bug 367667.
mq_overview.7
mtk
Reworded to reflect that capabilities are per-thread.
Add ioprio_set() to list of operations permitted by
CAP_SYS_NICE.
Add ioprio_set() IOPRIO_CLASS_RT and IOPRIO_CLASS_IDLE
scheduling classes to list op operations permitted by
CAP_SYS_ADMIN.
Note effects of CAP_SYS_NICE for migrate_pages().
Added section describing relationship between library
interfaces and system calls.
Added SEE ALSO referring to new mq_getsetattr.2.
feature_test_macros.7
Stefan Puiu
Fix typo: s/_POSIX_C_SOURCE/_POSIX_SOURCE/

View File

@ -4016,3 +4016,126 @@ time.7
ld.so.8
Justin Pryzby
Remove bogus duplicate line.
==================== Changes in man-pages-2.32 ====================
Released: 2006-05-13
Contributors
------------
The following people contributed notes, ideas, or patches that have
been incorporated in changes in this release:
Andries Brouwer <Andries.Brouwer@cwi.nl>
Johannes Weiner <root@hnaz.ath.cx>
Justin Pryzby <justinpryzby@users.sourceforge.net>
Karel Kulhavy <clock@twibright.com>
Paul Brook <paul@nowt.org>
Pavel Heimlich <tropikhajma@seznam.cz>
Apologies if I missed anyone!
New pages
---------
faccessat.2
mtk
New page for faccessat(2), new in 2.6.16.
fchmodat.2
mtk
New page for fchmodat(2), new in 2.6.16.
fchownat.2
mtk
New page for fchownat(2), new in 2.6.16.
futimesat.2
mtk
New page for futimesat(2), new in 2.6.16.
Changes to individual pages
---------------------------
access.2
mtk
Add SEE ALSO reference pointing to new faccessat.2 page.
capget.2
mtk
Reworded to reflect that capabilities are per-thread.
chmod.2
mtk
Add SEE ALSO reference pointing to new fchmodat.2 page.
chown.2
mtk
Add SEE ALSO reference pointing to new fchownat.2 page.
mmap.2
mtk
Updated discussion of MAP_NORESERVE since it is no longer
restricted to MAP_PRIVATE mappings.
Add reference to discussion of /proc/sys/vm/overcommit_memory
in proc.5.
openat.2
mtk
Add SEE ALSO reference pointing to new faccessat.2, fchmodat.2,
fchownat.2, futimesat.2 pages.
shmget.2
mtk
Document SHM_NORESERVE flag, new in 2.6.15.
truncate.2
Paul Brook / mtk
Expand text noting that ftruncate()/truncate() may fail if
asked to extend a file beyond its current length.
Add EPERM error.
utime.2
mtk
Add SEE ALSO reference pointing to new futimesat.2 page.
fopen.3
Justin Pryzby / mtk
Document 'm' (mmap) flag.
Debian bug 365754.
mtk
Document 'c' (notcancel) flag.
futimes.3
mtk
Add SEE ALSO reference pointing to new futimesat.2 page.
qsort.3
Johannes Weiner
Add missing "const" qualifies to cast in EXAMPLE.
mtk
Slight rewording of comments in EXAMPLE.
termios.3
Karel Kulhavy
Clarify meaning of IXANY.
Clarify relationship of MIN with VMIN and TIME with VTIME.
mtk
Noted that CIBAUD, OFDEL, and DELECHO are not implemented
on Linux.
Added explanatory paragraph for phrases "not in POSIX" and
"XSI".
capabilities.7
mtk
Reworded to reflect that capabilities are per-thread.
Add ioprio_set() to list of operations permitted by
CAP_SYS_NICE.
Add ioprio_set() IOPRIO_CLASS_RT and IOPRIO_CLASS_IDLE
scheduling classes to list of operations permitted by
CAP_SYS_ADMIN.
Note effects of CAP_SYS_NICE for migrate_pages().

View File

@ -227,7 +227,7 @@ If you are thinking of writing one or more of these pages, then:
-- You need to have a reasonably high degree of understanding of the
topic, or be prepared to invest the time (e.g., reading source code,
writing test programs) to gain that understanding. Writing test
programs is important; quite a few kernel and glibs bugs have been
programs is important; quite a few kernel and glibc bugs have been
uncovered while writing test programs during the preparation of
manual pages.
@ -270,7 +270,7 @@ request_key(2) (new in kernel 2.6.10)
See:
Documentation/keys.txt
Documentation/keys-request-key.txt
Requires CONFIG_KEYS (and optionally COFIG_KEYS_DEBUG_PROC_KEYS)
Requires CONFIG_KEYS (and optionally CONFIG_KEYS_DEBUG_PROC_KEYS)
under "Security options"
restart_syscall(2) (new in kernel 2.6)
@ -283,8 +283,6 @@ migrate_pages(2) (new in kernel 2.6.16)
preadv(2), pwritev(2) (new in ?? -- see
http://www.lwn.net/Articles/164887/ )
epoll_pwait(2) (probably will arrive in 2.6.17)
splice(2) Likely to be in 2.6.17.
See http://lwn.net/Articles/178199/
@ -296,6 +294,8 @@ sync_file_range(2) Likely to be in 2.6.17.
set_robust_list(2) Likely to be in 2.6.17
get_robust_list(2)
epoll_pwait(2) (probably will arrive in 2.6.18?)
/sys file system
----------------
@ -357,9 +357,11 @@ strptime_l(3) (since glibc 2.3.2)
sysv_signal(3)
updwtmpx(3)
sigandset(3), sigorset(3), sigisemptyset(3)
(perhaps on same page as sigemptyset(3))
backtrace(3)
backtrace_symbols(3)
backtrace_fd(3)
(There are info pages for these functions. See also
page 48 of http://people.redhat.com/~drepper/tut1.ps)
argp_error(3)
argp_failure(3)
@ -409,10 +411,11 @@ http://people.redhat.com/~drepper/asynchnl.pdf)
Various wide character functions (with their traditional equivalents
mentioned in parentheses):
wcscoll(3) (strcoll(3))
wcsxfrm(3) (strxfrm(3))
wscanf(3) (scanf(3))
and fwscanf(3), swscanf(3), vfwscanf(3), vswscanf(3)
wcschrnul(3) (strchrnul(3))
wcswcs(3) (strstr(3))
wcscoll(3) (strcoll(3))
wcsftime(3) (strftime(3))
wcstod(3) (strtod(3))
wcstof(3) (strtof(3))
wcstold(3) (strtold(3))
@ -424,10 +427,8 @@ wcstoull(3) (strtoull(3))
wcstoq(3) (atoq(3))
wcstoq(3) (strtoq(3))
wcstouq(3) (strtouq(3))
wscanf(3) (scanf(3))
and fwscanf(3), swscanf(3), vfwscanf(3), vswscanf(3)
wcsftime(3) (strftime(3))
wcswcs(3) (strstr(3))
wcsxfrm(3) (strxfrm(3))
After these manual pages are written, add SEE ALSO entries
from the pages for the traditional functions to the pages
describing their wide-character equivalents.