From 0c094170df0cfb516617aea401a5322d505bcd3a Mon Sep 17 00:00:00 2001 From: Michael Kerrisk Date: Mon, 9 Feb 2009 21:24:52 +1300 Subject: [PATCH] Start of man-pages-3.19: updating Changes and Changes.old --- Changes | 338 +---------------------------------------------- Changes.old | 370 ++++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 372 insertions(+), 336 deletions(-) diff --git a/Changes b/Changes index 1c7c5f6dd..41a886d18 100644 --- a/Changes +++ b/Changes @@ -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 -Bastien ROUCARIES -Christian Siebert -Christopher Head -Florentin Duneau -Guillem Jover -Lefteris Dimitroulakis -Lucio Maciel -Michael Kerrisk -Mike Frysinger -Peter Zijlstra -Petr Baudis -Sam Varshavchik -Satyam Sharma -Sebastian Kienzl -Timo Sirainen -Vegard Nossum 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 " - -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) diff --git a/Changes.old b/Changes.old index 0555ecebd..5cef40ea0 100644 --- a/Changes.old +++ b/Changes.old @@ -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 +Bastien ROUCARIES +Christian Siebert +Christopher Head +Florentin Duneau +Guillem Jover +Lefteris Dimitroulakis +Lucio Maciel +Michael Kerrisk +Mike Frysinger +Peter Zijlstra +Petr Baudis +Sam Varshavchik +Satyam Sharma +Sebastian Kienzl +Timo Sirainen +Vegard Nossum + +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 " + +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)