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

This commit is contained in:
Michael Kerrisk 2009-02-09 21:24:52 +13:00
parent c762c1c907
commit 0c094170df
2 changed files with 372 additions and 336 deletions

338
Changes
View File

@ -1,6 +1,6 @@
==================== Changes in man-pages-3.18 ====================
==================== Changes in man-pages-3.19 ====================
Released: 2009-02-10, Christchurch
Released: ????-??-??, Christchurch
Contributors
@ -9,23 +9,6 @@ Contributors
The following people contributed notes, ideas, or patches that have
been incorporated in changes in this release:
Andi Kleen <andi@firstfloor.org>
Bastien ROUCARIES <roucaries.bastien@gmail.com>
Christian Siebert <christian.siebert@s2000.tu-chemnitz.de>
Christopher Head <chead@telus.net>
Florentin Duneau <fduneau@gmail.com>
Guillem Jover <guillem@debian.org>
Lefteris Dimitroulakis <edimitro@tee.gr>
Lucio Maciel <luciofm@gmail.com>
Michael Kerrisk <mtk.manpages@gmail.com>
Mike Frysinger <vapier@gentoo.org>
Peter Zijlstra <peterz@infradead.org>
Petr Baudis <pasky@suse.cz>
Sam Varshavchik <mrsam@courier-mta.com>
Satyam Sharma <ssatyam@cse.iitk.ac.in>
Sebastian Kienzl <seb@riot.org>
Timo Sirainen <tss@iki.fi>
Vegard Nossum <vegard.nossum@gmail.com>
Apologies if I missed anyone!
@ -33,336 +16,19 @@ Apologies if I missed anyone!
New and rewritten pages
-----------------------
armscii-8.7
Lefteris Dimitroulakis
New page documenting ArmSCII-8 character set
iso_8859-11.7
Lefteris Dimitroulakis
New page documenting ISO 8859-11 character set
iso_8859-4.7
Lefteris Dimitroulakis
New page documenting ISO 8859-4 character set
iso_8859-6.7
Lefteris Dimitroulakis
New page describing ISO 8859-6 character set
pthread_kill.3
Michael Kerrisk
New page documenting pthread_kill(3)
pthread_kill_other_threads_np.3
Michael Kerrisk
New page documenting pthread_kill_other_threads_np(3)
pthread_sigmask.3
Michael Kerrisk
New page documenting pthread_sigmask(3)
Newly documented interfaces in existing pages
---------------------------------------------
clock_getres.3
Michael Kerrisk
Document CLOCK_MONOTONIC_RAW, new in 2.6.28
New and changed links
---------------------
clock_gettime.2
clock_settime.2
clock_getres.3
clock_gettime.3
clock_settime.3
Michael Kerrisk
Update links to reflect the fact that clock_* pages are now in
Section 2
iso-8859-11.7
iso_8859_11.7
Michael Kerrisk
New links to new iso_8859-11.7
iso-8859-4.7
iso_8859_4.7
latin4.7
Michael Kerrisk
New links to new iso_8859-4.7
iso-8859-6.7
iso_8859_6.7
Michael Kerrisk
New links to new iso_8859-6.7
tis-620.7
Michael Kerrisk
New link to new iso_8859-11.7
Global changes
--------------
clock_nanosleep.2
getrusage.2
timerfd_create.2
clock.3
clock_getcpuclockid.3
ftime.3
pthread_create.3
pthread_getcpuclockid.3
pthread_tryjoin_np.3
sem_wait.3
time.7
Michael Kerrisk
Global fix: Fix xrefs to clock_*.? pages to reflect move to section 2
clock_nanosleep.2
execve.2
fork.2
nanosleep.2
sigaction.2
timerfd_create.2
pthread_getcpuclockid.3
ualarm.3
usleep.3
pthreads.7
time.7
Michael Kerrisk
Global fix: s/(3)/(2)/ in section number xrefs for timer_*() API
The POSIX timers API is implemented (mostly) within the kernel,
so thse interfaces are system calls. Although there are as yet
no man pages, when they are added they should be in Section 2,
not 3. Therefore fix those pages that currently refer to these
interfaces as being in Section 3.
Changes to individual pages
---------------------------
capget.2
Andi Kleen
Add some details and relocate a paragraph
While writing a little program using capset
I found the capset manpage quite light on crucial
details and I had to resort to RTFS.
This patch improves the points I found unclear
and also moves one misplaced paragraph around.
clock_getres.2
Michael Kerrisk
Move page from Section 3 to Section 2
eventfd.2
Michael Kerrisk
glibc eventfd() supports the use of eventfd2() since version 2.9
fork.2
Michael Kerrisk
SEE ALSO: add daemon(3)
getdents.2
Michael Kerrisk
Remove unneeded HAVE_D_TYPE from example program
Since d_type will always just return DT_UNKNOWN before
kernel 2.6.4, we don't need to use a conditional for
determining whether we use this flag.
nanosleep.2
Michael Kerrisk
Relocated misplaced BUGS heading
select_tut.2
Michael Kerrisk
Clean up error checking in example program (no semantic changes)
Michael Kerrisk
Many parts tidied and rewritten
Remove some redundant text, clarify various pieces,
tidy example code, etc.
Michael Kerrisk
Bug fixes + rewrites in example program
Sebastien pointed out that the first example program
wrongly thinks it can count signals.
Also, some further rewrites by mtk.
socket.2
Michael Kerrisk
BUGS: Remove discussion SOCK_UUCP
As time goes on, this sentence becomes less a piece of humor,
and more a puzzle.
stat.2
Michael Kerrisk
Note that open(O_NOATIME) also causes st_atime not to be updated
timerfd_create.2
Michael Kerrisk
Add BUGS noting that timerfd supports fewer clock types than
timer_create()
btowc.3
Michael Kerrisk
SEE ALSO: add wctob(3)
clock_getcpuclockid.3
Michael Kerrisk
SEE ALSO: add pthread_getcpuclockid(3)
cos.3
Michael Kerrisk
SEE ALSO: add sincos(3)
fexecve.3
Timo Sirainen
Note that fexecve() depends on a mounted /proc
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=514043
Michael Kerrisk
CONFORMING TO: note addition of fexecve() in POSIX.1-2008
Michael Kerrisk
'fd' must be opened read-only and refer to a file that is executable
fmemopen.3
Michael Kerrisk
CONFORMING TO: note that these functions are in POSIX.1-2008
getifaddrs.3
Lucio Maciel
Fix memory leak in example program
Petr Baudis
Various small fixes
getpwnam.3
Michael Kerrisk
SEE ALSO: add getspnam(3)
getumask.3
Michael Kerrisk
Updated glibc version number in NOTES
ilogb.3
Michael Kerrisk
SEE ALSO: add significand(3)
intro.3
Michael Kerrisk
SEE ALSO: add libc(7)
isalpha.3
Michael Kerrisk
Fix statement that isalpa() is obsolete; should be isascii()
http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=512709
Michael Kerrisk
SEE ALSO: add toascii(3)
mq_notify.3
Michael Kerrisk
Add cross reference to pthread_attr_init(3)
pthread_attr_setaffinity_np.3
Michael Kerrisk
SYNOPSIS: Fix declaration of 'attr'
pthread_getcpuclockid.3
Michael Kerrisk
SYNOPSIS: fix type of 'thread'
qsort.3
Michael Kerrisk
EXAMPLE: remove unnecessary "#include <stdlib.h>"
random.3
Michael Kerrisk
SEE ALSO: add random_r(3)
remainder.3
Michael Kerrisk
SEE ALSO: add div(3)
scandir.3
Michael Kerrisk
CONFORMING TO: alphasort() and scandir() are added to POSIX.1-2008
Michael Kerrisk
CONFORMING TO: note that versionsort() was added to glibc in
version 2.1
sem_wait.3
Michael Kerrisk
SEE ALSO: add clock_getime(2)
significand.3
Michael Kerrisk
Add CONFORMING TO noting that this function is unstandardized
sigwait.3
Michael Kerrisk
Add EXAMPLES section referring to pthread_sigmask(3)
sin.3
Michael Kerrisk
SEE ALSO: add sincos(3)
stpcpy.3
Michael Kerrisk
Add BUGS section noting the possibility of buffer overruns
Michael Kerrisk
Add missing pieces/fix various problems in example program
Michael Kerrisk
CONFORMING TO: stpcpy() is nowadays on the BSDs
Michael Kerrisk
wspfix
Michael Kerrisk
SEE ALSO: add stpcpy.3
wcscasecmp.3
Michael Kerrisk
CONFORMING TO: note that this function is added in POSIX.1-2008
wcsdup.3
Michael Kerrisk
CONFORMING TO: note that this function was added in POSIX.1-2008
wcsncasecmp.3
Michael Kerrisk
CONFORMING TO: note that this function is added in POSIX.1-2008
wctob.3
Michael Kerrisk
SEE ALSO: add btowc(3)
proc.5
Michael Kerrisk
Remove mention of epoll/max_user_instances
(Since this interface appeared in 2.6.28, and then
disappeared in 2.6.29.)
ascii.7
Michael Kerrisk
Update SEE ALSO list to include pages added in 3.17
Michael Kerrisk
SEE ALSO: add recently added iso_8859-*(7) pages
epoll.7
Michael Kerrisk
remove documentation of /proc/sys/fs/epoll/max_user_instances
This /proc interface appeared in 2.6.28. but will be
removed in 2.6.29.
Also, document change in default value of
/proc/sys/fs/epoll/max_user_watches (was 1/32 of lowmem,
now 1/25 of lowmem).
koi8-r.7
Michael Kerrisk
SEE ALSO: add koi8-u(7); remove crufty text
standards.7
Michael Kerrisk
Update to note that latest POSIX/SUS was ratified in 2008
time.7
Michael Kerrisk
SEE ALSO: add pthread_getcpuclockid(3)

View File

@ -17559,3 +17559,373 @@ proc.5
epoll.7
Michael Kerrisk
Various wording changes to improve clarity and consistency
==================== Changes in man-pages-3.18 ====================
Released: 2009-02-10, Christchurch
Contributors
------------
The following people contributed notes, ideas, or patches that have
been incorporated in changes in this release:
Andi Kleen <andi@firstfloor.org>
Bastien ROUCARIES <roucaries.bastien@gmail.com>
Christian Siebert <christian.siebert@s2000.tu-chemnitz.de>
Christopher Head <chead@telus.net>
Florentin Duneau <fduneau@gmail.com>
Guillem Jover <guillem@debian.org>
Lefteris Dimitroulakis <edimitro@tee.gr>
Lucio Maciel <luciofm@gmail.com>
Michael Kerrisk <mtk.manpages@gmail.com>
Mike Frysinger <vapier@gentoo.org>
Peter Zijlstra <peterz@infradead.org>
Petr Baudis <pasky@suse.cz>
Sam Varshavchik <mrsam@courier-mta.com>
Satyam Sharma <ssatyam@cse.iitk.ac.in>
Sebastian Kienzl <seb@riot.org>
Timo Sirainen <tss@iki.fi>
Vegard Nossum <vegard.nossum@gmail.com>
Apologies if I missed anyone!
New and rewritten pages
-----------------------
armscii-8.7
Lefteris Dimitroulakis
New page documenting ArmSCII-8 character set
iso_8859-11.7
Lefteris Dimitroulakis
New page documenting ISO 8859-11 character set
iso_8859-4.7
Lefteris Dimitroulakis
New page documenting ISO 8859-4 character set
iso_8859-6.7
Lefteris Dimitroulakis
New page describing ISO 8859-6 character set
pthread_kill.3
Michael Kerrisk
New page documenting pthread_kill(3)
pthread_kill_other_threads_np.3
Michael Kerrisk
New page documenting pthread_kill_other_threads_np(3)
pthread_sigmask.3
Michael Kerrisk
New page documenting pthread_sigmask(3)
Newly documented interfaces in existing pages
---------------------------------------------
clock_getres.3
Michael Kerrisk
Document CLOCK_MONOTONIC_RAW, new in 2.6.28
New and changed links
---------------------
clock_gettime.2
clock_settime.2
clock_getres.3
clock_gettime.3
clock_settime.3
Michael Kerrisk
Update links to reflect the fact that clock_* pages are now in
Section 2
iso-8859-11.7
iso_8859_11.7
Michael Kerrisk
New links to new iso_8859-11.7
iso-8859-4.7
iso_8859_4.7
latin4.7
Michael Kerrisk
New links to new iso_8859-4.7
iso-8859-6.7
iso_8859_6.7
Michael Kerrisk
New links to new iso_8859-6.7
tis-620.7
Michael Kerrisk
New link to new iso_8859-11.7
Global changes
--------------
clock_nanosleep.2
getrusage.2
timerfd_create.2
clock.3
clock_getcpuclockid.3
ftime.3
pthread_create.3
pthread_getcpuclockid.3
pthread_tryjoin_np.3
sem_wait.3
time.7
Michael Kerrisk
Global fix: Fix xrefs to clock_*.? pages to reflect move to section 2
clock_nanosleep.2
execve.2
fork.2
nanosleep.2
sigaction.2
timerfd_create.2
pthread_getcpuclockid.3
ualarm.3
usleep.3
pthreads.7
time.7
Michael Kerrisk
Global fix: s/(3)/(2)/ in section number xrefs for timer_*() API
The POSIX timers API is implemented (mostly) within the kernel,
so thse interfaces are system calls. Although there are as yet
no man pages, when they are added they should be in Section 2,
not 3. Therefore fix those pages that currently refer to these
interfaces as being in Section 3.
Changes to individual pages
---------------------------
capget.2
Andi Kleen
Add some details and relocate a paragraph
While writing a little program using capset
I found the capset manpage quite light on crucial
details and I had to resort to RTFS.
This patch improves the points I found unclear
and also moves one misplaced paragraph around.
clock_getres.2
Michael Kerrisk
Move page from Section 3 to Section 2
eventfd.2
Michael Kerrisk
glibc eventfd() supports the use of eventfd2() since version 2.9
fork.2
Michael Kerrisk
SEE ALSO: add daemon(3)
getdents.2
Michael Kerrisk
Remove unneeded HAVE_D_TYPE from example program
Since d_type will always just return DT_UNKNOWN before
kernel 2.6.4, we don't need to use a conditional for
determining whether we use this flag.
nanosleep.2
Michael Kerrisk
Relocated misplaced BUGS heading
select_tut.2
Michael Kerrisk
Clean up error checking in example program (no semantic changes)
Michael Kerrisk
Many parts tidied and rewritten
Remove some redundant text, clarify various pieces,
tidy example code, etc.
Michael Kerrisk
Bug fixes + rewrites in example program
Sebastien pointed out that the first example program
wrongly thinks it can count signals.
Also, some further rewrites by mtk.
socket.2
Michael Kerrisk
BUGS: Remove discussion SOCK_UUCP
As time goes on, this sentence becomes less a piece of humor,
and more a puzzle.
stat.2
Michael Kerrisk
Note that open(O_NOATIME) also causes st_atime not to be updated
timerfd_create.2
Michael Kerrisk
Add BUGS noting that timerfd supports fewer clock types than
timer_create()
btowc.3
Michael Kerrisk
SEE ALSO: add wctob(3)
clock_getcpuclockid.3
Michael Kerrisk
SEE ALSO: add pthread_getcpuclockid(3)
cos.3
Michael Kerrisk
SEE ALSO: add sincos(3)
fexecve.3
Timo Sirainen
Note that fexecve() depends on a mounted /proc
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=514043
Michael Kerrisk
CONFORMING TO: note addition of fexecve() in POSIX.1-2008
Michael Kerrisk
'fd' must be opened read-only and refer to a file that is executable
fmemopen.3
Michael Kerrisk
CONFORMING TO: note that these functions are in POSIX.1-2008
getifaddrs.3
Lucio Maciel
Fix memory leak in example program
Petr Baudis
Various small fixes
getpwnam.3
Michael Kerrisk
SEE ALSO: add getspnam(3)
getumask.3
Michael Kerrisk
Updated glibc version number in NOTES
ilogb.3
Michael Kerrisk
SEE ALSO: add significand(3)
intro.3
Michael Kerrisk
SEE ALSO: add libc(7)
isalpha.3
Michael Kerrisk
Fix statement that isalpa() is obsolete; should be isascii()
http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=512709
Michael Kerrisk
SEE ALSO: add toascii(3)
mq_notify.3
Michael Kerrisk
Add cross reference to pthread_attr_init(3)
pthread_attr_setaffinity_np.3
Michael Kerrisk
SYNOPSIS: Fix declaration of 'attr'
pthread_getcpuclockid.3
Michael Kerrisk
SYNOPSIS: fix type of 'thread'
qsort.3
Michael Kerrisk
EXAMPLE: remove unnecessary "#include <stdlib.h>"
random.3
Michael Kerrisk
SEE ALSO: add random_r(3)
remainder.3
Michael Kerrisk
SEE ALSO: add div(3)
scandir.3
Michael Kerrisk
CONFORMING TO: alphasort() and scandir() are added to POSIX.1-2008
Michael Kerrisk
CONFORMING TO: note that versionsort() was added to glibc in
version 2.1
sem_wait.3
Michael Kerrisk
SEE ALSO: add clock_getime(2)
significand.3
Michael Kerrisk
Add CONFORMING TO noting that this function is unstandardized
sigwait.3
Michael Kerrisk
Add EXAMPLES section referring to pthread_sigmask(3)
sin.3
Michael Kerrisk
SEE ALSO: add sincos(3)
stpcpy.3
Michael Kerrisk
Add BUGS section noting the possibility of buffer overruns
Michael Kerrisk
Add missing pieces/fix various problems in example program
Michael Kerrisk
CONFORMING TO: stpcpy() is nowadays on the BSDs
Michael Kerrisk
wspfix
Michael Kerrisk
SEE ALSO: add stpcpy.3
wcscasecmp.3
Michael Kerrisk
CONFORMING TO: note that this function is added in POSIX.1-2008
wcsdup.3
Michael Kerrisk
CONFORMING TO: note that this function was added in POSIX.1-2008
wcsncasecmp.3
Michael Kerrisk
CONFORMING TO: note that this function is added in POSIX.1-2008
wctob.3
Michael Kerrisk
SEE ALSO: add btowc(3)
proc.5
Michael Kerrisk
Remove mention of epoll/max_user_instances
(Since this interface appeared in 2.6.28, and then
disappeared in 2.6.29.)
ascii.7
Michael Kerrisk
Update SEE ALSO list to include pages added in 3.17
Michael Kerrisk
SEE ALSO: add recently added iso_8859-*(7) pages
epoll.7
Michael Kerrisk
remove documentation of /proc/sys/fs/epoll/max_user_instances
This /proc interface appeared in 2.6.28. but will be
removed in 2.6.29.
Also, document change in default value of
/proc/sys/fs/epoll/max_user_watches (was 1/32 of lowmem,
now 1/25 of lowmem).
koi8-r.7
Michael Kerrisk
SEE ALSO: add koi8-u(7); remove crufty text
standards.7
Michael Kerrisk
Update to note that latest POSIX/SUS was ratified in 2008
time.7
Michael Kerrisk
SEE ALSO: add pthread_getcpuclockid(3)