LDP
/
man-pages
mirror of https://github.com/mkerrisk/man-pages
0
1
Fork 0
Code Releases Activity

Start of 2.45

This commit is contained in:
Michael Kerrisk 2007-04-03 11:41:48 +00:00
parent 8cf0f93250
commit 46857e1025
2 changed files with 410 additions and 383 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

385
Changes
View File

@ -1,6 +1,6 @@
==================== Changes in man-pages-2.44 ====================
Released: 2007-04-04
Released: 2007-??-??
Contributors
------------
@ -8,401 +8,20 @@ Contributors
The following people contributed notes, ideas, or patches that have
been incorporated in changes in this release:
Andre Majorel <aym-naideb@teaser.fr>
Benjamin Gilbert <bgilbert@cs.cmu.edu>
Carlo Marcelo Arenas Belon <carenas@sajinet.com.pe>
Chuck Ebbert <76306.1226@compuserve.com>
Ivana Varekova <varekova@redhat.com>
Jakub Jelinek <jakub@redhat.com>
John Ward <jward@idealcorp.com>
Jorge Peixoto de Morais Neto <jorgepeixotomorais@gmail.com>
Julien Blache <jblache@debian.org>
Julien Cristau <jcristau@debian.org>
Justin Pryzby <justinpryzby@users.sourceforge.net>
Martín Ferrari <martin.ferrari@gmail.com>
Mike Frysinger <vapier@gentoo.org>
Nick Piggin <npiggin@suse.de>
Nick Pollitt <npollitt@mvista.com>
Nicolas François <nicolas.francois@centraliens.ne>
Pádraig Brady <P@draigBrady.com>
Premysl Hruby <dfenze@gmail.com>
Reuben Thomas <rrt@sc3d.org>
Samuel Thibault <samuel.thibault@ens-lyon.org>
Serge E. Hallyn <serge@hallyn.com>
Thomas Huriaux <thomas.huriaux@gmail.com>
Timo Sirainen <tss@iki.fi>
Val Henson <val_henson@linux.interl.com>
Apologies if I missed anyone!
New pages
---------
termio.7
mtk, after a bit of prodding by Reuben Thomas
A brief discussion of the old System V termio interface,
with pointers to pages that will contain the information
that the reader probably wants.
scripts/find_repeated_words.sh
mtk
Find consecutive duplicate words in a man page, some of
which may me grammar errors.
Global changes
--------------
mtk
JustinPyzby / mtk
Add "#define _ATFILE_SOURCE" to SYNOPSIS in following pages:
faccessat.2
fchmodat.2
fchownat.2
fstatat.2
futimesat.2
linkat.2
mkdirat.2
mknodat.2
openat.2
readlinkat.2
renameat.2
symlinkat.2
unlinkat.2
mkfifoat.3
mtk
Various references to "getty" were changed to "mingetty", since
that is the manual page more likely to be found on current systems.
mtk, after a suggestion by Reuben Thomas <rrt@sc3d.org>
Updated various header pages to accurately reflect which functions
are and are not part of C89. Also fixed/improved a few other
CONFORMING TO entries.
mtk
s/Unices/Unix systems/ on the 5 pages where it appears.
mtk
Wrapped long source lines in the following files
man2/getsockopt.2
man2/mknodat.2
man2/io_setup.2
man2/select_tut.2
man2/select.2
man2/readlinkat.2
man2/io_cancel.2
man2/syslog.2
man3/wcsncat.3
man3/getipnodebyname.3
man3/cmsg.3
man3/wcpncpy.3
man3/wcsrtombs.3
man3/wcstok.3
man3/fgetwc.3
man3/wmemcmp.3
man3/wcsspn.3
man3/div.3
man3/modf.3
man3/stdio_ext.3
man3/ctermid.3
man3/des_crypt.3
man3/wcsncmp.3
man3/wmemchr.3
man3/wcsstr.3
man3/wmemcpy.3
man3/wprintf.3
man3/wcsnrtombs.3
man3/termios.3
man3/erf.3
man3/ceil.3
man3/lround.3
man3/nextafter.3
man3/wcsncpy.3
man3/wmemset.3
man3/getw.3
man4/console_ioctl.4
man4/sk98lin.4
man7/environ.7
man7/unix.7
man7/time.7
mtk
Added a SEE ALSO reference for feature_test_macros(7) to all
pages where a feature test macro appears in the SYNOPSIS.
mtk
Added SEE ALSO entry pointing to time.7
alarm.2
nanosleep.2
ualarm.3
usleep.3
Justin Pryzby / mtk
Fixed consecutive duplicate word typos on a number of pages.
Typographical or grammatical errors have been corrected in several
places. (Special thanks to Nicolas François!)
places.
Changes to individual pages
---------------------------
access.2
mtk
Since 2.6.20, access() honours the MS_NOEXEC mount flag.
Jorge Peixoto de Morais Neto / mtk
Improve ENOENT description.
clone.2
mtk
Added some detail to the prototype.
Added some notes on IA-64's clone2().
epoll_ctl.2
mtk
Add text to note that EPOLLRDHUP appeared in kernel 2.6.17.
faccessat.2
Justin Pryzby
Various fixes as per Debian bug 411177.
* s/effective/real/ in description test.
* added <fcntl.h> to synopsis.
* various other changes.
getrlimit.2
mtk / Fedora downstream patches; thanks to Ivana Varekova
Added a few words to note that RLIMIT_NPROC is really a limit on
threads.
io_cancel.2
io_destroy.2
io_getevents.2
io_setup.2
io_submit.2
Fedora downstream patches; thanks to Ivana Varekova
s%linux/aio.h%libaio.h% in SYNOPSIS.
Changed return type from "long" to "int".
mbind.2
Samuel Thibault / mtk
Fix EINVAL description.
See Debian bug 411777.
mincore.2
Nick Piggin
Kernel 2.6.21 fixes several earlier bugs in mincore().
Nick Pollitt
Remove words "of a file" -- mincore() is describing
memory residence information, not properties of a file.
mtk
Rewrote various parts to make the page clearer.
mmap.2
mtk
Rewrote and reorganised various parts to be clearer.
Taken from Fedora downstream patches; thanks to Ivana Varekova
Removed text stating that mmap() never returns 0; that's
not true.
mount.2
mtk / Val Henson
Document MS_RELATIME, new in Linux 2.6.20.
open.2
Andre Majorel / mtk
On Linux, the error returned when opening a large file on a
32-bit system is actually EFBIG, not EOVERFLOW.
posix_fadvise.2
Pádraig Brady
Fix RETURN VALUE description: returns error number of failure.
rename.2
mtk / Timo Sirainen
Various improvements to DESCRIPTION.
See Debian bug 416012.
semop.2
mtk
If sops contains multiple operations, then these are performed
in array order. All Unix systems that I know of do this,
and some Linux applications depend on this behaviour. SUSv3
made no explicit statement here, but SUSv3 will explicitly
require this behaviour.
Small rewording of explanation of "atomically".
signal.2
Nicolas François
Fix incorrect argument name in DESCRIPTION.
mtk
Small wording improvement.
socket.2
Nicolas François
Add reference to ipv6.7 page.
socketcall.2
Nicolas François
Fix .TH line.
splice.2
Benjamin Gilbert
Fix inconsistent argument names in SYNOPSIS and DESCRIPTION.
statvfs.2
mtk
Small wording clarification.
symlink.2
mtk / Nicolas François
Removed cryptic text under CONFORMING to referring to
"open(2) and NFS". There is no relevant text in open.2 as
far as I (mtk) can see.
time.2
mtk / Reuben Thomas
Remove sentence "gettimeofday() obsoleting time() on 4.3BSD".
This information is old, and probably no longer relevant.
See Debian bug 403888.
write.2
mtk, after an idea from a downstream Fedora patch.
Clarified discussion of /count == 0/ case.
ptrace.2
Chuck Ebbert
When the parent receives an event with PTRACE_EVENT_* set,
the child is not in the normal signal delivery path. This
means the parent cannot do ptrace(PTRACE_CONT) with a signal
or ptrace(PTRACE_KILL). kill() with a SIGKILL signal can be
used instead to kill the child process after receiving one
of these messages.
sched_setaffinity.2
mtk
Fix glibc version number in description of cpusetsize argument.
vfork.2
mtk
Stripped some excess/outdated text from the BUGS section.
basename.3
mtk / Jorge Peixoto de Morais Neto
Add text to clarify that the pointer returned by these
functions may be into some part of 'path'.
dlopen.3
Taken from Fedora downstream patches; thanks to Ivana Varekova
+ Carlo Marcelo Arenas Belon
Add "#include <stdlib.h>" to example program.
fclose.3
mtk
Complete rewrite. The existing page was hard to read,
and the RETURN VALUE description seems to be wrong.
getopt.3
mtk
Added getopt() example program.
mtk
Add a few words to clarify the operation of the GNU-specific double-colon
feature, which allows options to have optional arguments.
See Debian bug352139.
glob.3
Nicolas François
Fix PROTOTYPE.
inet_network.3
mtk, after an idea from a downstream Fedora patch.
Clarified description of inet_network().
log.3
Nicolas François
Fix .TH line.
log10.3
Nicolas François
Fix .TH line.
malloc.3
Nicolas François
Small rewording to mention calloc().
posix_openpt.3
Martín Ferrari
Fix return type in SYNOPSIS; as per Debian bug 400971.
Needs _XOPEN_SOURCE == 600; as per Debian bug 400975.
Julien BLACHE
s/ptsname/posix_openpt/ in RETURN VALUE
re_comp.3
Taken from Fedora downstream patches; thanks to Ivana Varekova
Add "#define _REGEX_RE_COMP" to SYNOPSIS.
regex.3
Nicolas François
Fix .TH line.
termios.3
mtk
Added .SS headers to give some structure to this page; and a small
amount of reordering.
mtk
Added a section on canonical and non-canonical mode.
mtk
Enhanced the discussion of "raw" mode for cfmakeraw().
mtk
Document CMSPAR.
mtk
Make description of PARODD a little clearer.
Reuben Thomas
Add SEE ALSO link to tty_ioctl.4
mtk
Add SEE ALSO link to console_ioctl.4
ualarm.3
mtk
Removed BSD prototype from synopsis.
Various rewordings.
usleep.3
mtk
Removed BSD prototype from synopsis.
Various rewordings.
termcap.5
Taken from Fedora downstream patches; thanks to Ivana Varekova
s/curses/ncurses/ under SEE ALSO
bootparam.7
Taken from Fedora downstream patches; thanks to Ivana Varekova
Documented "mem=nopentium".
feature_test_macros.7
mtk
The default treatment of _POSIX_C_SOURCE changed in glibc 2.4.
mtk, after a suggestion by Justin Pryzby
Added some text warning that the "__" macros the
<features.h> defines internally should never be
directly defined by programs.
mtk, based on notes by Jakub Jelinek
Document _FORTIFY_SOURCE
(See http://gcc.gnu.org/ml/gcc-patches/2004-09/msg02055.html )
mtk
Document _REENTRANT and _THREAD_SAFE.
mdoc.7
mtk / Nicolas François
Remove CONFIGURATION section, since this does not seem to be
true for Linux.
svipc.7
Nicolas François
Fix data types in associated data structures;
remove non-existent semzcnt and semncnt fields.
time.7
mtk
Since kernel 2.6.20, the software clock can also be 300 HZ.

408
Changes.old
View File

@ -5442,4 +5442,412 @@ udp.7
Andi Kleen
Describe the correct default for UDP/RAW path MTU discovery.
==================== Changes in man-pages-2.44 ====================
Released: 2007-04-04
Contributors
------------
The following people contributed notes, ideas, or patches that have
been incorporated in changes in this release:
Andre Majorel <aym-naideb@teaser.fr>
Benjamin Gilbert <bgilbert@cs.cmu.edu>
Carlo Marcelo Arenas Belon <carenas@sajinet.com.pe>
Chuck Ebbert <76306.1226@compuserve.com>
Ivana Varekova <varekova@redhat.com>
Jakub Jelinek <jakub@redhat.com>
John Ward <jward@idealcorp.com>
Jorge Peixoto de Morais Neto <jorgepeixotomorais@gmail.com>
Julien Blache <jblache@debian.org>
Julien Cristau <jcristau@debian.org>
Justin Pryzby <justinpryzby@users.sourceforge.net>
Martín Ferrari <martin.ferrari@gmail.com>
Mike Frysinger <vapier@gentoo.org>
Nick Piggin <npiggin@suse.de>
Nick Pollitt <npollitt@mvista.com>
Nicolas François <nicolas.francois@centraliens.ne>
Pádraig Brady <P@draigBrady.com>
Premysl Hruby <dfenze@gmail.com>
Reuben Thomas <rrt@sc3d.org>
Samuel Thibault <samuel.thibault@ens-lyon.org>
Serge E. Hallyn <serge@hallyn.com>
Thomas Huriaux <thomas.huriaux@gmail.com>
Timo Sirainen <tss@iki.fi>
Val Henson <val_henson@linux.interl.com>
Apologies if I missed anyone!
New pages
---------
termio.7
mtk, after a bit of prodding by Reuben Thomas
A brief discussion of the old System V termio interface,
with pointers to pages that will contain the information
that the reader probably wants.
scripts/find_repeated_words.sh
mtk
Find consecutive duplicate words in a man page, some of
which may me grammar errors.
Global changes
--------------
mtk
Justin Pryzby / mtk
Add "#define _ATFILE_SOURCE" to SYNOPSIS in following pages:
faccessat.2
fchmodat.2
fchownat.2
fstatat.2
futimesat.2
linkat.2
mkdirat.2
mknodat.2
openat.2
readlinkat.2
renameat.2
symlinkat.2
unlinkat.2
mkfifoat.3
mtk
Various references to "getty" were changed to "mingetty", since
that is the manual page more likely to be found on current systems.
mtk, after a suggestion by Reuben Thomas <rrt@sc3d.org>
Updated various header pages to accurately reflect which functions
are and are not part of C89. Also fixed/improved a few other
CONFORMING TO entries.
mtk
s/Unices/Unix systems/ on the 5 pages where it appears.
mtk
Wrapped long source lines in the following files
man2/getsockopt.2
man2/mknodat.2
man2/io_setup.2
man2/select_tut.2
man2/select.2
man2/readlinkat.2
man2/io_cancel.2
man2/syslog.2
man3/wcsncat.3
man3/getipnodebyname.3
man3/cmsg.3
man3/wcpncpy.3
man3/wcsrtombs.3
man3/wcstok.3
man3/fgetwc.3
man3/wmemcmp.3
man3/wcsspn.3
man3/div.3
man3/modf.3
man3/stdio_ext.3
man3/ctermid.3
man3/des_crypt.3
man3/wcsncmp.3
man3/wmemchr.3
man3/wcsstr.3
man3/wmemcpy.3
man3/wprintf.3
man3/wcsnrtombs.3
man3/termios.3
man3/erf.3
man3/ceil.3
man3/lround.3
man3/nextafter.3
man3/wcsncpy.3
man3/wmemset.3
man3/getw.3
man4/console_ioctl.4
man4/sk98lin.4
man7/environ.7
man7/unix.7
man7/time.7
mtk
Added a SEE ALSO reference for feature_test_macros(7) to all
pages where a feature test macro appears in the SYNOPSIS.
mtk
Added SEE ALSO entry pointing to time.7
alarm.2
nanosleep.2
ualarm.3
usleep.3
Justin Pryzby / mtk
Fixed consecutive duplicate word typos on a number of pages.
Typographical or grammatical errors have been corrected in several
places. (Special thanks to Nicolas François!)
Changes to individual pages
---------------------------
access.2
mtk
Since 2.6.20, access() honours the MS_NOEXEC mount flag.
Jorge Peixoto de Morais Neto / mtk
Improve ENOENT description.
clone.2
mtk
Added some detail to the prototype.
Added some notes on IA-64's clone2().
epoll_ctl.2
mtk
Add text to note that EPOLLRDHUP appeared in kernel 2.6.17.
faccessat.2
Justin Pryzby
Various fixes as per Debian bug 411177.
* s/effective/real/ in description test.
* added <fcntl.h> to synopsis.
* various other changes.
getrlimit.2
mtk / Fedora downstream patches; thanks to Ivana Varekova
Added a few words to note that RLIMIT_NPROC is really a limit on
threads.
io_cancel.2
io_destroy.2
io_getevents.2
io_setup.2
io_submit.2
Fedora downstream patches; thanks to Ivana Varekova
s%linux/aio.h%libaio.h% in SYNOPSIS.
Changed return type from "long" to "int".
mbind.2
Samuel Thibault / mtk
Fix EINVAL description.
See Debian bug 411777.
mincore.2
Nick Piggin
Kernel 2.6.21 fixes several earlier bugs in mincore().
Nick Pollitt
Remove words "of a file" -- mincore() is describing
memory residence information, not properties of a file.
mtk
Rewrote various parts to make the page clearer.
mmap.2
mtk
Rewrote and reorganised various parts to be clearer.
Taken from Fedora downstream patches; thanks to Ivana Varekova
Removed text stating that mmap() never returns 0; that's
not true.
mount.2
mtk / Val Henson
Document MS_RELATIME, new in Linux 2.6.20.
open.2
Andre Majorel / mtk
On Linux, the error returned when opening a large file on a
32-bit system is actually EFBIG, not EOVERFLOW.
posix_fadvise.2
Pádraig Brady
Fix RETURN VALUE description: returns error number of failure.
rename.2
mtk / Timo Sirainen
Various improvements to DESCRIPTION.
See Debian bug 416012.
semop.2
mtk
If sops contains multiple operations, then these are performed
in array order. All Unix systems that I know of do this,
and some Linux applications depend on this behaviour. SUSv3
made no explicit statement here, but SUSv3 will explicitly
require this behaviour.
Small rewording of explanation of "atomically".
signal.2
Nicolas François
Fix incorrect argument name in DESCRIPTION.
mtk
Small wording improvement.
socket.2
Nicolas François
Add reference to ipv6.7 page.
socketcall.2
Nicolas François
Fix .TH line.
splice.2
Benjamin Gilbert
Fix inconsistent argument names in SYNOPSIS and DESCRIPTION.
statvfs.2
mtk
Small wording clarification.
symlink.2
mtk / Nicolas François
Removed cryptic text under CONFORMING to referring to
"open(2) and NFS". There is no relevant text in open.2 as
far as I (mtk) can see.
time.2
mtk / Reuben Thomas
Remove sentence "gettimeofday() obsoleting time() on 4.3BSD".
This information is old, and probably no longer relevant.
See Debian bug 403888.
write.2
mtk, after an idea from a downstream Fedora patch.
Clarified discussion of /count == 0/ case.
ptrace.2
Chuck Ebbert
When the parent receives an event with PTRACE_EVENT_* set,
the child is not in the normal signal delivery path. This
means the parent cannot do ptrace(PTRACE_CONT) with a signal
or ptrace(PTRACE_KILL). kill() with a SIGKILL signal can be
used instead to kill the child process after receiving one
of these messages.
sched_setaffinity.2
mtk
Fix glibc version number in description of cpusetsize argument.
vfork.2
mtk
Stripped some excess/outdated text from the BUGS section.
basename.3
mtk / Jorge Peixoto de Morais Neto
Add text to clarify that the pointer returned by these
functions may be into some part of 'path'.
dlopen.3
Taken from Fedora downstream patches; thanks to Ivana Varekova
+ Carlo Marcelo Arenas Belon
Add "#include <stdlib.h>" to example program.
fclose.3
mtk
Complete rewrite. The existing page was hard to read,
and the RETURN VALUE description seems to be wrong.
getopt.3
mtk
Added getopt() example program.
mtk
Add a few words to clarify the operation of the GNU-specific double-colon
feature, which allows options to have optional arguments.
See Debian bug352139.
glob.3
Nicolas François
Fix PROTOTYPE.
inet_network.3
mtk, after an idea from a downstream Fedora patch.
Clarified description of inet_network().
log.3
Nicolas François
Fix .TH line.
log10.3
Nicolas François
Fix .TH line.
malloc.3
Nicolas François
Small rewording to mention calloc().
posix_openpt.3
Martín Ferrari
Fix return type in SYNOPSIS; as per Debian bug 400971.
Needs _XOPEN_SOURCE == 600; as per Debian bug 400975.
Julien BLACHE
s/ptsname/posix_openpt/ in RETURN VALUE
re_comp.3
Taken from Fedora downstream patches; thanks to Ivana Varekova
Add "#define _REGEX_RE_COMP" to SYNOPSIS.
regex.3
Nicolas François
Fix .TH line.
termios.3
mtk
Added .SS headers to give some structure to this page; and a small
amount of reordering.
mtk
Added a section on canonical and non-canonical mode.
mtk
Enhanced the discussion of "raw" mode for cfmakeraw().
mtk
Document CMSPAR.
mtk
Make description of PARODD a little clearer.
Reuben Thomas
Add SEE ALSO link to tty_ioctl.4
mtk
Add SEE ALSO link to console_ioctl.4
ualarm.3
mtk
Removed BSD prototype from synopsis.
Various rewordings.
usleep.3
mtk
Removed BSD prototype from synopsis.
Various rewordings.
termcap.5
Taken from Fedora downstream patches; thanks to Ivana Varekova
s/curses/ncurses/ under SEE ALSO
bootparam.7
Taken from Fedora downstream patches; thanks to Ivana Varekova
Documented "mem=nopentium".
feature_test_macros.7
mtk
The default treatment of _POSIX_C_SOURCE changed in glibc 2.4.
mtk, after a suggestion by Justin Pryzby
Added some text warning that the "__" macros the
<features.h> defines internally should never be
directly defined by programs.
mtk, based on notes by Jakub Jelinek
Document _FORTIFY_SOURCE
(See http://gcc.gnu.org/ml/gcc-patches/2004-09/msg02055.html )
mtk
Document _REENTRANT and _THREAD_SAFE.
mdoc.7
mtk / Nicolas François
Remove CONFIGURATION section, since this does not seem to be
true for Linux.
svipc.7
Nicolas François
Fix data types in associated data structures;
remove non-existent semzcnt and semncnt fields.
time.7
mtk
Since kernel 2.6.20, the software clock can also be 300 HZ.