mirror of https://github.com/mkerrisk/man-pages
Start of man-pages-3.37: updating Changes and Changes.old
This commit is contained in:
parent
97e625cd1c
commit
db8e5ab15e
194
Changes
194
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 <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!
|
||||
|
||||
|
@ -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 <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>
|
||||
|
|
213
Changes.old
213
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>
|
||||
|
|
Loading…
Reference in New Issue