From db8e5ab15ec4a6ca9c847ce5627f7e889c64a797 Mon Sep 17 00:00:00 2001 From: Michael Kerrisk Date: Mon, 27 Feb 2012 14:19:00 +1300 Subject: [PATCH] Start of man-pages-3.37: updating Changes and Changes.old --- Changes | 194 +++-------------------------------------------- Changes.old | 213 ++++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 222 insertions(+), 185 deletions(-) diff --git a/Changes b/Changes index 19af44588..fe4cca5bb 100644 --- a/Changes +++ b/Changes @@ -1,6 +1,6 @@ -==================== Changes in man-pages-3.36 ==================== +==================== Changes in man-pages-3.37 ==================== -Released: 2012-02-27, Christchurch +Released: ????-??-??, Munich Contributors @@ -10,29 +10,6 @@ The following people contributed patches/fixes or (noted in brackets in the changelog below) reports, notes and ideas that have been incorporated in changes in this release: -Alain Benedetti -carado -Christoph Hellwig -Clemens Ladisch -David Prévot -Elie De Brauwer -Guillem Jover -Jessica McKellar -Josef Bacik -Junjiro Okajima -Lucian Adrian Grijincu -Michael Kerrisk -Mike Frysinger -Pat Pannuto -Salvo Tomaselli -Simone Piccardi -Slaven Rezic -starlight@binnacle.cx -Stephan Mueller -Vijay Rao -Walter Haidinger -Walter Harms -Yang Yang Apologies if I missed anyone! @@ -40,172 +17,19 @@ Apologies if I missed anyone! New and rewritten pages ----------------------- -sendmmsg.2 - Michael Kerrisk [Stephan Mueller] - New page for sendmmsg(2) - Some pieces inspired by an initial attempt by Stephan Mueller. - Newly documented interfaces in existing pages --------------------------------------------- -fallocate.2 - Lucian Adrian Grijincu - Document FALLOC_FL_PUNCH_HOLE - FALLOC_FL_PUNCH_HOLE was added in Linux 2.6.38, - for punching holes in the allocated space in a file. + +New and changed links +--------------------- + + +Global changes +-------------- Changes to individual pages --------------------------- -dup.2 - Michael Kerrisk - SYNOPSIS: Add "#include " for O_* constants - -fallocate.2 - Michael Kerrisk - Substantial restructuring of DESCRIPTION - The addition of a second class of operation ("hole punching") - to the man page made it clear that some significant restructuring - is required. So I substantially reworked the page, including the - preexisting material on the default "file allocation" operation. - Michael Kerrisk [Josef Bacik] - Add further details for FALLOC_FL_PUNCH_HOLE - Michael Kerrisk - ERRORS: Add EPERM error case for FALLOC_FL_PUNCH_HOLE - -fork.2 - Michael Kerrisk - NOTES: Describe clone() call equivalent to fork() - -fsync.2 - Christoph Hellwig - Various improvements - - explain the situation with disk caches better - - remove the duplicate fdatasync() explanation in the NOTES - section - - remove an incorrect note about fsync() generally requiring two - writes - - remove an obsolete ext2 example note - - fsync() works on any file descriptor (doesn't need to be - writable); correct the EBADF error code explanation - Michael Kerrisk [Guillem Jover] - Note that some systems require a writable file descriptor - An edited version of Guillem Jover's comments: - [While the file descriptor does not need to be writable on Linux] - that's not a safe portable assumption to make on POSIX in general - as that behavior is not specified and as such is - implementation-specific. Some Unix systems do actually fail on - read-only file descriptors, for example [HP-UX and AIX]. - -mount.2 - Michael Kerrisk [Junjiro Okajima] - Removed erroneous statement about MS_RDONLY and bind mounts - -open.2 - Jessica McKellar - Fix grammar in O_DIRECT description - Some small grammar fixes to the O_DIRECT description. - -pipe.2 - Michael Kerrisk [Salvo Tomaselli] - SYNOPSIS: Add "#include " for O_* constants - See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=659750 - -sched_rr_get_interval.2 - Clemens Ladisch - Update notes on modifying quantum - Since Linux 2.6.24, it is no longer possible to - modify the SCHED_RR quantum using setpriority(2). - (Slight edits to Clemens' patch by mtk.) - Michael Kerrisk - Reordered various pieces of text - Michael Kerrisk - Reworded text of ESRCH error - -send.2 - Michael Kerrisk - Add mention of sendmmsg(2) - -sync.2 - Michael Kerrisk [Simone Piccardi] - PROTOTYPE: Fix return type of syncfs() - -vfork.2 - Michael Kerrisk [starlight@binnacle.cx] - Clarify what is duplicated in the child - Add some words to make it clear to the reader that vfork(), - like fork(), creates duplicates of process attributes - in the child. - Michael Kerrisk - Note clone() flags equivalent to vfork() - Michael Kerrisk [starlight@binnacle.cx, Mike Frysinger] - Add some notes on reasons why vfork() still exists - Michael Kerrisk [starlight@binnacle.cx] - Clarify that calling *thread* is suspended during vfork() - Michael Kerrisk - CONFORMING TO: Note that POSIX.1-2001 marked vfork() obsolete - -gets.3 - Michael Kerrisk - Document C11 and glibc 2.16 changes affecting gets() - -pthread_sigmask.3 - Michael Kerrisk [Pat Pannuto] - Fix comment that was inconsistent with code in example program - -sem_wait.3 - Walter Harms - EXAMPLE: Remove extraneous line of output from shell session - -wcsnrtombs.3 -wcsrtombs.3 -wcstombs.3 - Michael Kerrisk - Fix-ups for e9c23bc636426366d659809bc99cd84661e86464 - -core.5 - Michael Kerrisk [Junjiro Okajima] - Document %E specifier for core_pattern - -passwd.5 - Michael Kerrisk [Walter Haidinger] - s/asterisk/asterisk (*)/ to improve clarity - Michael Kerrisk - Correct note on passwd field value when shadowing is enabled - When password shadowing is enabled, the password field - contains an 'x' (not a "8'). - -proc.5 - Elie De Brauwer - Fix description of fourth field of /proc/loadavg - SIgned-off-by: Elie De Brauwer - -resolv.conf.5 - Michael Kerrisk [Slaven Rezic] - Describe syntax used for comments - See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=656994 - -feature_test_macros.7 - Michael Kerrisk - Document _ISOC11_SOURCE - -inotify.7 - Michael Kerrisk [Yang Yang] - Note that 'cookie' field is set to zero when unused - -man.7 - Michael Kerrisk - Various fixes for description of NAME section - As noted by reporter: - * The code sample given for the NAME section is incomplete because - the actual content sample is not given. - * Additionally, the description assumes that the item described is - a command, which need not be the case. - * The command makewhatis is not present on my system; the - documented tool to create the whatis database is called mandb. - * The description on .SH NAME in man(7) should either copy the - relevant paragraph of lexgrog(1) or refer to it. - - Reported by: Kristof Zelechovski diff --git a/Changes.old b/Changes.old index 276549261..fa1e2b399 100644 --- a/Changes.old +++ b/Changes.old @@ -22410,3 +22410,216 @@ proc.5 capabilities.7 Michael Kerrisk List setns(2) as an operation allowed by CAP_SYS_ADMIN + + +==================== Changes in man-pages-3.36 ==================== + +Released: 2012-02-27, Christchurch + + +Contributors +------------ + +The following people contributed patches/fixes or (noted in brackets +in the changelog below) reports, notes and ideas that have been +incorporated in changes in this release: + +Alain Benedetti +carado +Christoph Hellwig +Clemens Ladisch +David Prévot +Elie De Brauwer +Guillem Jover +Jessica McKellar +Josef Bacik +Junjiro Okajima +Lucian Adrian Grijincu +Michael Kerrisk +Mike Frysinger +Pat Pannuto +Salvo Tomaselli +Simone Piccardi +Slaven Rezic +starlight@binnacle.cx +Stephan Mueller +Vijay Rao +Walter Haidinger +Walter Harms +Yang Yang + +Apologies if I missed anyone! + + +New and rewritten pages +----------------------- + +sendmmsg.2 + Michael Kerrisk [Stephan Mueller] + New page for sendmmsg(2) + Some pieces inspired by an initial attempt by Stephan Mueller. + + +Newly documented interfaces in existing pages +--------------------------------------------- + +fallocate.2 + Lucian Adrian Grijincu + Document FALLOC_FL_PUNCH_HOLE + FALLOC_FL_PUNCH_HOLE was added in Linux 2.6.38, + for punching holes in the allocated space in a file. + + +Changes to individual pages +--------------------------- + +dup.2 + Michael Kerrisk + SYNOPSIS: Add "#include " for O_* constants + +fallocate.2 + Michael Kerrisk + Substantial restructuring of DESCRIPTION + The addition of a second class of operation ("hole punching") + to the man page made it clear that some significant restructuring + is required. So I substantially reworked the page, including the + preexisting material on the default "file allocation" operation. + Michael Kerrisk [Josef Bacik] + Add further details for FALLOC_FL_PUNCH_HOLE + Michael Kerrisk + ERRORS: Add EPERM error case for FALLOC_FL_PUNCH_HOLE + +fork.2 + Michael Kerrisk + NOTES: Describe clone() call equivalent to fork() + +fsync.2 + Christoph Hellwig + Various improvements + - explain the situation with disk caches better + - remove the duplicate fdatasync() explanation in the NOTES + section + - remove an incorrect note about fsync() generally requiring two + writes + - remove an obsolete ext2 example note + - fsync() works on any file descriptor (doesn't need to be + writable); correct the EBADF error code explanation + Michael Kerrisk [Guillem Jover] + Note that some systems require a writable file descriptor + An edited version of Guillem Jover's comments: + [While the file descriptor does not need to be writable on Linux] + that's not a safe portable assumption to make on POSIX in general + as that behavior is not specified and as such is + implementation-specific. Some Unix systems do actually fail on + read-only file descriptors, for example [HP-UX and AIX]. + +mount.2 + Michael Kerrisk [Junjiro Okajima] + Removed erroneous statement about MS_RDONLY and bind mounts + +open.2 + Jessica McKellar + Fix grammar in O_DIRECT description + Some small grammar fixes to the O_DIRECT description. + +pipe.2 + Michael Kerrisk [Salvo Tomaselli] + SYNOPSIS: Add "#include " for O_* constants + See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=659750 + +sched_rr_get_interval.2 + Clemens Ladisch + Update notes on modifying quantum + Since Linux 2.6.24, it is no longer possible to + modify the SCHED_RR quantum using setpriority(2). + (Slight edits to Clemens' patch by mtk.) + Michael Kerrisk + Reordered various pieces of text + Michael Kerrisk + Reworded text of ESRCH error + +send.2 + Michael Kerrisk + Add mention of sendmmsg(2) + +sync.2 + Michael Kerrisk [Simone Piccardi] + PROTOTYPE: Fix return type of syncfs() + +vfork.2 + Michael Kerrisk [starlight@binnacle.cx] + Clarify what is duplicated in the child + Add some words to make it clear to the reader that vfork(), + like fork(), creates duplicates of process attributes + in the child. + Michael Kerrisk + Note clone() flags equivalent to vfork() + Michael Kerrisk [starlight@binnacle.cx, Mike Frysinger] + Add some notes on reasons why vfork() still exists + Michael Kerrisk [starlight@binnacle.cx] + Clarify that calling *thread* is suspended during vfork() + Michael Kerrisk + CONFORMING TO: Note that POSIX.1-2001 marked vfork() obsolete + +gets.3 + Michael Kerrisk + Document C11 and glibc 2.16 changes affecting gets() + +pthread_sigmask.3 + Michael Kerrisk [Pat Pannuto] + Fix comment that was inconsistent with code in example program + +sem_wait.3 + Walter Harms + EXAMPLE: Remove extraneous line of output from shell session + +wcsnrtombs.3 +wcsrtombs.3 +wcstombs.3 + Michael Kerrisk + Fix-ups for e9c23bc636426366d659809bc99cd84661e86464 + +core.5 + Michael Kerrisk [Junjiro Okajima] + Document %E specifier for core_pattern + +passwd.5 + Michael Kerrisk [Walter Haidinger] + s/asterisk/asterisk (*)/ to improve clarity + Michael Kerrisk + Correct note on passwd field value when shadowing is enabled + When password shadowing is enabled, the password field + contains an 'x' (not a "8'). + +proc.5 + Elie De Brauwer + Fix description of fourth field of /proc/loadavg + SIgned-off-by: Elie De Brauwer + +resolv.conf.5 + Michael Kerrisk [Slaven Rezic] + Describe syntax used for comments + See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=656994 + +feature_test_macros.7 + Michael Kerrisk + Document _ISOC11_SOURCE + +inotify.7 + Michael Kerrisk [Yang Yang] + Note that 'cookie' field is set to zero when unused + +man.7 + Michael Kerrisk + Various fixes for description of NAME section + As noted by reporter: + * The code sample given for the NAME section is incomplete because + the actual content sample is not given. + * Additionally, the description assumes that the item described is + a command, which need not be the case. + * The command makewhatis is not present on my system; the + documented tool to create the whatis database is called mandb. + * The description on .SH NAME in man(7) should either copy the + relevant paragraph of lexgrog(1) or refer to it. + + Reported by: Kristof Zelechovski