diff --git a/Changes b/Changes index f4db13ea6..19af44588 100644 --- a/Changes +++ b/Changes @@ -1,6 +1,6 @@ ==================== Changes in man-pages-3.36 ==================== -Released: 2011-11-12, Munich +Released: 2012-02-27, Christchurch Contributors @@ -10,6 +10,29 @@ 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! @@ -17,19 +40,172 @@ 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 --------------------------------------------- - -New and changed links ---------------------- - - -Global changes --------------- +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