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

1 files changed, 213 insertions, 0 deletions

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 <alainb06@free.fr>
+carado <carado@savhon.org>
+Christoph Hellwig <hch@lst.de>
+Clemens Ladisch <clemens@ladisch.de>
+David Prévot <taffit@debian.org>
+Elie De Brauwer <eliedebrauwer@gmail.com>
+Guillem Jover <guillem@hadrons.org>
+Jessica McKellar <jesstess@mit.edu>
+Josef Bacik <josef@redhat.com>
+Junjiro Okajima <jro@mx3.ttcn.ne.jp>
+Lucian Adrian Grijincu <lucian.grijincu@gmail.com>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Mike Frysinger <vapier@gentoo.org>
+Pat Pannuto <pat.pannuto@gmail.com>
+Salvo Tomaselli <tiposchi@tiscali.it>
+Simone Piccardi <piccardi@truelite.it>
+Slaven Rezic <srezic@iconmobile.com>
+starlight@binnacle.cx
+Stephan Mueller <stephan.mueller@atsec.com>
+Vijay Rao <vijay@portuosus.com>
+Walter Haidinger <walter.haidinger@gmx.at>
+Walter Harms <wharms@bfs.de>
+Yang Yang <wdscxsj@gmail.com>
+
+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 <fntl.h>" 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 <fntl.h>" 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 <eliedebrauwer@gmail.com>
+
+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 <giecrilj@stegny.2a.pl>