aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorMichael Kerrisk <mtk.manpages@gmail.com>2013-03-05 18:27:59 +0100
committerMichael Kerrisk <mtk.manpages@gmail.com>2013-03-05 18:27:59 +0100
commitf82bd24e46aa899402ec366d3488a9b7365bae98 (patch)
tree110e69b8a4517ba1202d712d5653eacbc34ca0bf
parent11ea62f3061c965708e664474590b89ca4b3867b (diff)
downloadman-pages-f82bd24e46aa899402ec366d3488a9b7365bae98.tar.gz
Start of man-pages-3.49: updating Changes and Changes.old
-rw-r--r--Changes244
-rw-r--r--Changes.old277
2 files changed, 279 insertions, 242 deletions
diff --git a/Changes b/Changes
index 9c0d97cfab..50625a49d2 100644
--- a/Changes
+++ b/Changes
@@ -1,6 +1,6 @@
-==================== Changes in man-pages-3.48 ====================
+==================== Changes in man-pages-3.49 ====================
-Released: 2013-03-05, Munich
+Released: ????-??-??, Munich
Contributors
@@ -10,31 +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:
-Andrey Vagin <avagin@openvz.org>
-Aristeu Rozanski <aris@ruivo.org>
-Colin Walters <walters@verbum.org>
-Cyril Hrubis <chrubis@suse.cz>
-Cyrill Gorcunov <gorcunov@openvz.org>
-Daniel P. Berrange <berrange@redhat.com>
-David Prévot <taffit@debian.org>
-D. Barbier <bouzim@gmail.com>
-Denys Vlasenko <vda.linux@googlemail.com>
-Flavio Leitner <fbl@redhat.com>
-Graham Gower <graham.gower@gmail.com>
-Ivana Varekova <varekova@redhat.com>
-Kai Kunschke <kai@kunfoo.org>
-Marcela Maslanova <mmaslano@redhat.com>
-Marc Lehmann <debian-reportbug@plan9.de>
-Marshel Abraham <Marshel.Abraham@in.bosch.com>
-Michael Kerrisk <mtk.manpages@gmail.com>
-Nathan Stratton Treadway <kernelbugs@nathanst.com>
-Pavel Emelyanov <xemul@parallels.com>
-Peter Schiffer <pschiffe@redhat.com>
-Simon Heimberg <simohe@besonet.ch>
-Simon Paillard <spaillard@debian.org>
-Török Edwin <edwintorok@gmail.com>
-Ulrich Drepper <drepper@redhat.com>
-Zack Weinberg <zackw@panix.com>
Apologies if I missed anyone!
@@ -42,234 +17,19 @@ Apologies if I missed anyone!
New and rewritten pages
-----------------------
-getunwind.2
- Marcela Maslanova
- New page documenting getunwind(2)
- Taken from Red Hat downstream man pages set
- Michael Kerrisk
- Much rewriting
- Some text taken from arch/ia64/kernel/unwind.c.
-
-perfmonctl.2
- Ivana Varekova
- New page documenting IA-64-specific perfmonctl(2)
- Taken from Red Hat downstream man pages
- Michael Kerrisk
- Rework discussion of PFM_CREATE_CONTEXT
- Add VERSIONS and CONFORMING TO
- Note that there is no glibc wrapper
- Remove PFM_CREATE_EVTSETS, PFM_DELETE_EVTSETS, PFM_GETINFO_EVTSETS
- These don't exist, and it appears they never have.
- Fix argument types for PFM_WRITE_PMCS, PFM_WRITE_PMDS, PFM_READ_PMDS
- The types that were being used don't exist!
- Briefly document PFM_GET_FEATURES, PFM_DEBUG, PFM_GET_PMC_RESET_VAL
-
-gai.conf.5
- Ulrich Drepper
- New page documenting gai.conf
- Taken from Red Hat downstream pages
-
-nss.conf.5
- Ulrich Drepper
- New page describing nss.conf
-
Newly documented interfaces in existing pages
---------------------------------------------
-clock_getres.2
- Cyril Hrubis
- Document CLOCK_REALTIME_COARSE and CLOCK_MONOTONIC_COARSE
- Cyril Hrubis
- Document CLOCK_BOOTTIME
- Michael Kerrisk
- Some improvements to CLOCK_BOOTTIME description
-
-ptrace.2
- Denys Vlasenko
- Document PTRACE_GETREGSET, PTRACE_SETREGSET, PTRACE_SEIZE, and friends
- Document PTRACE_GETREGSET, PTRACE_SETREGSET,
- PTRACE_SEIZE, PTRACE_INTERRUPT, and PTRACE_LISTEN.
-
New and changed links
---------------------
-fattach.2
-fdetach.2
-getmsg.2
-isastream.2
-putmsg.2
- Michael Kerrisk [Peter Schiffer]
- New link to unimplemented.2
- Taken from Red Hat downstream.
-
- See https://bugzilla.redhat.com/show_bug.cgi?id=436407
-
Global changes
--------------
-Many pages
- Michael Kerrisk
- Global fix: remove unneeded double quotes in .SH headings
-
-Many pages
- Michael Kerrisk
- Global fix: remove unneeded double quotes in .SS headings
-
-Many pages
- Michael Kerrisk
- Global fix: use consistent capitalization in .SS headings
- Capitalization in .SS sections across pages (and sometimes even
- within a single page) is wildly inconsistent. Make it consistent.
- Capitalize first word in heading, but otherwise use lower case,
- except where English usage (e.g., proper nouns) or programming
- language requirements (e.g., identifier names) dictate otherwise.
-Many pages
- Michael Kerrisk [Denys Vlasenko]
- Remove double blank lines in output
-
-Various pages
- Michael Kerrisk
- Fix order of SH sections
-
Changes to individual pages
---------------------------
-accept.2
- Michael Kerrisk
- NAME: Add "accept4"
-
-access.2
- Colin Walters
- Note that access() may also fail for FUSE
- Since in some cases (e.g. libguestfs's guestmount) it also has the
- semantics where files can appear owned by root, but are actually
- mutable by the user, despite what one might infer from the Unix
- permissions.
-
-getpeername.2
- Michael Kerrisk [Kai Kunschke]
- Clarify semantics of getpeername() for datagram sockets
- See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=674034
-
-getuid.2
- Michael Kerrisk
- Remove duplicate section heading
-
-mmap.2
- Cyril Hrubis
- Add note about partial page in BUGS section
- This adds a note about Linux behavior with partial page at the end
- of the object. The problem here is that a page that contains only
- part of a file (because the file size is not multiple of PAGE_SIZE)
- stays in page cache even after the mapping is unmapped and the file
- is closed. So if some process dirties such page, other mappings
- will see the changes rather than zeroes.
- Michael Kerrisk [Török Edwin]
- Some 'flags' values require a feature test macro to be defined
- Add text to NOTES noting that some MAP_* constants are
- defined only if a suitable feature test macro is defined.
- See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=542601
- Cyril Hrubis
- Document EOVERFLOW error
-
-open.2
- Michael Kerrisk
- Clarify list of file creation flags
- POSIX.1-2008 TC1 clarified this, so that O_CLOEXEC,
- O_DIRECTORY, and O_NOFOLLOW are also in this list.
-
-prctl.2
- Cyrill Gorcunov
- Add some details for PR_GET_TID_ADDRESS
-
-read.2
- Michael Kerrisk [Zack Weinberg]
- Clarify interaction of count==0 and error checking
- POSIX deliberately leaves this case open, so the man
- page should be less specific about what happens.
-
- See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=533232
- Michael Kerrisk [Marc Lehmann]
- Remove crufty text about O_NONBLOCK on files
- See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=700529
- Michael Kerrisk
- Clarify details for seekable files
-
-unimplemented.2
- Michael Kerrisk [Peter Schiffer]
- Add various STREAMS interfaces to NAME
- Taken from Red Hat downstream.
-
- See https://bugzilla.redhat.com/show_bug.cgi?id=436407
-
-cexp2.3
- Michael Kerrisk
- Still does not exist in glibc 2.17
-
-exit.3
- Michael Kerrisk
- Note that a call to execve() clears exit handler registrations
-
-getaddrinfo.3
- Michael Kerrisk
- SEE ALSO: Add gai.conf(5)
-
-malloc_trim.3
- Michael Kerrisk
- Remove duplicate section title
-
-printf.3
- Marshel Abraham [Graham Gower, Graham Gower]
- Fix error handling in example code
- See https://bugzilla.kernel.org/show_bug.cgi?id=23282
-
-pthread_yield.3
- Michael Kerrisk [Aristeu Rozanski]
- Add _GNU_SOURCE feature test macro to SYNOPSIS
-
-resolver.3
-resolv.conf.5
- Michael Kerrisk [Nathan Stratton Treadway, Simon Heimberg]
- RES_DEBUG is only available if glibc is compiled with debug support
- See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=692136
- and https://bugzilla.kernel.org/show_bug.cgi?id=43061
-
-strtol.3
- Michael Kerrisk [Peter Schiffer]
- Remove crufty text from previous fix
-
-core.5
- Michael Kerrisk
- Document CONFIG_COREDUMP
-
-capabilities.7
- Andrey Vagin
- Nonexistent bits are no longer shown as set in /proc/PID/status Cap*
-
-inotify.7
- Michael Kerrisk
- A monitoring process can't easily distinguish events triggered by itself
-
-ip.7
- Flavio Leitner [Peter Schiffer]
- Improve explanation about calling listen() or connect()
-
-man-pages.7
- Michael Kerrisk
- Describe rules for capitalization in .SS headings
-
-rtnetlink.7
- Pavel Emelyanov
- Add info about ability to create links with given index
- Since kernel v3.7 the RTM_NEWLINK message now accepts nonzero
- values in ifi_index field. Mention this fact in the respective
- rtnetlink.7 section.
-
-socket.7
- Pavel Emelyanov
- SO_BINDTODEVICE is now readable
- SO_BINDTODEVICE is readable since since kernel 3.8.
diff --git a/Changes.old b/Changes.old
index ca370e102c..a7e58b7471 100644
--- a/Changes.old
+++ b/Changes.old
@@ -25814,3 +25814,280 @@ zdump.8
Michael Kerrisk [Peter Schiffer]
Bring up to date with zdump --help
Patch taken from Red Hat downstream.
+
+
+==================== Changes in man-pages-3.48 ====================
+
+Released: 2013-03-05, Munich
+
+
+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:
+
+Andrey Vagin <avagin@openvz.org>
+Aristeu Rozanski <aris@ruivo.org>
+Colin Walters <walters@verbum.org>
+Cyril Hrubis <chrubis@suse.cz>
+Cyrill Gorcunov <gorcunov@openvz.org>
+Daniel P. Berrange <berrange@redhat.com>
+David Prévot <taffit@debian.org>
+D. Barbier <bouzim@gmail.com>
+Denys Vlasenko <vda.linux@googlemail.com>
+Flavio Leitner <fbl@redhat.com>
+Graham Gower <graham.gower@gmail.com>
+Ivana Varekova <varekova@redhat.com>
+Kai Kunschke <kai@kunfoo.org>
+Marcela Maslanova <mmaslano@redhat.com>
+Marc Lehmann <debian-reportbug@plan9.de>
+Marshel Abraham <Marshel.Abraham@in.bosch.com>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Nathan Stratton Treadway <kernelbugs@nathanst.com>
+Pavel Emelyanov <xemul@parallels.com>
+Peter Schiffer <pschiffe@redhat.com>
+Simon Heimberg <simohe@besonet.ch>
+Simon Paillard <spaillard@debian.org>
+Török Edwin <edwintorok@gmail.com>
+Ulrich Drepper <drepper@redhat.com>
+Zack Weinberg <zackw@panix.com>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+getunwind.2
+ Marcela Maslanova
+ New page documenting getunwind(2)
+ Taken from Red Hat downstream man pages set
+ Michael Kerrisk
+ Much rewriting
+ Some text taken from arch/ia64/kernel/unwind.c.
+
+perfmonctl.2
+ Ivana Varekova
+ New page documenting IA-64-specific perfmonctl(2)
+ Taken from Red Hat downstream man pages
+ Michael Kerrisk
+ Rework discussion of PFM_CREATE_CONTEXT
+ Add VERSIONS and CONFORMING TO
+ Note that there is no glibc wrapper
+ Remove PFM_CREATE_EVTSETS, PFM_DELETE_EVTSETS, PFM_GETINFO_EVTSETS
+ These don't exist, and it appears they never have.
+ Fix argument types for PFM_WRITE_PMCS, PFM_WRITE_PMDS, PFM_READ_PMDS
+ The types that were being used don't exist!
+ Briefly document PFM_GET_FEATURES, PFM_DEBUG, PFM_GET_PMC_RESET_VAL
+
+gai.conf.5
+ Ulrich Drepper
+ New page documenting gai.conf
+ Taken from Red Hat downstream pages
+
+nss.conf.5
+ Ulrich Drepper
+ New page describing nss.conf
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+clock_getres.2
+ Cyril Hrubis
+ Document CLOCK_REALTIME_COARSE and CLOCK_MONOTONIC_COARSE
+ Cyril Hrubis
+ Document CLOCK_BOOTTIME
+ Michael Kerrisk
+ Some improvements to CLOCK_BOOTTIME description
+
+ptrace.2
+ Denys Vlasenko
+ Document PTRACE_GETREGSET, PTRACE_SETREGSET, PTRACE_SEIZE, and friends
+ Document PTRACE_GETREGSET, PTRACE_SETREGSET,
+ PTRACE_SEIZE, PTRACE_INTERRUPT, and PTRACE_LISTEN.
+
+
+New and changed links
+---------------------
+
+fattach.2
+fdetach.2
+getmsg.2
+isastream.2
+putmsg.2
+ Michael Kerrisk [Peter Schiffer]
+ New link to unimplemented.2
+ Taken from Red Hat downstream.
+
+ See https://bugzilla.redhat.com/show_bug.cgi?id=436407
+
+
+Global changes
+--------------
+
+Many pages
+ Michael Kerrisk
+ Global fix: remove unneeded double quotes in .SH headings
+
+Many pages
+ Michael Kerrisk
+ Global fix: remove unneeded double quotes in .SS headings
+
+Many pages
+ Michael Kerrisk
+ Global fix: use consistent capitalization in .SS headings
+ Capitalization in .SS sections across pages (and sometimes even
+ within a single page) is wildly inconsistent. Make it consistent.
+ Capitalize first word in heading, but otherwise use lower case,
+ except where English usage (e.g., proper nouns) or programming
+ language requirements (e.g., identifier names) dictate otherwise.
+Many pages
+ Michael Kerrisk [Denys Vlasenko]
+ Remove double blank lines in output
+
+Various pages
+ Michael Kerrisk
+ Fix order of SH sections
+
+
+Changes to individual pages
+---------------------------
+
+accept.2
+ Michael Kerrisk
+ NAME: Add "accept4"
+
+access.2
+ Colin Walters
+ Note that access() may also fail for FUSE
+ Since in some cases (e.g. libguestfs's guestmount) it also has the
+ semantics where files can appear owned by root, but are actually
+ mutable by the user, despite what one might infer from the Unix
+ permissions.
+
+getpeername.2
+ Michael Kerrisk [Kai Kunschke]
+ Clarify semantics of getpeername() for datagram sockets
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=674034
+
+getuid.2
+ Michael Kerrisk
+ Remove duplicate section heading
+
+mmap.2
+ Cyril Hrubis
+ Add note about partial page in BUGS section
+ This adds a note about Linux behavior with partial page at the end
+ of the object. The problem here is that a page that contains only
+ part of a file (because the file size is not multiple of PAGE_SIZE)
+ stays in page cache even after the mapping is unmapped and the file
+ is closed. So if some process dirties such page, other mappings
+ will see the changes rather than zeroes.
+ Michael Kerrisk [Török Edwin]
+ Some 'flags' values require a feature test macro to be defined
+ Add text to NOTES noting that some MAP_* constants are
+ defined only if a suitable feature test macro is defined.
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=542601
+ Cyril Hrubis
+ Document EOVERFLOW error
+
+open.2
+ Michael Kerrisk
+ Clarify list of file creation flags
+ POSIX.1-2008 TC1 clarified this, so that O_CLOEXEC,
+ O_DIRECTORY, and O_NOFOLLOW are also in this list.
+
+prctl.2
+ Cyrill Gorcunov
+ Add some details for PR_GET_TID_ADDRESS
+
+read.2
+ Michael Kerrisk [Zack Weinberg]
+ Clarify interaction of count==0 and error checking
+ POSIX deliberately leaves this case open, so the man
+ page should be less specific about what happens.
+
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=533232
+ Michael Kerrisk [Marc Lehmann]
+ Remove crufty text about O_NONBLOCK on files
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=700529
+ Michael Kerrisk
+ Clarify details for seekable files
+
+unimplemented.2
+ Michael Kerrisk [Peter Schiffer]
+ Add various STREAMS interfaces to NAME
+ Taken from Red Hat downstream.
+
+ See https://bugzilla.redhat.com/show_bug.cgi?id=436407
+
+cexp2.3
+ Michael Kerrisk
+ Still does not exist in glibc 2.17
+
+exit.3
+ Michael Kerrisk
+ Note that a call to execve() clears exit handler registrations
+
+getaddrinfo.3
+ Michael Kerrisk
+ SEE ALSO: Add gai.conf(5)
+
+malloc_trim.3
+ Michael Kerrisk
+ Remove duplicate section title
+
+printf.3
+ Marshel Abraham [Graham Gower, Graham Gower]
+ Fix error handling in example code
+ See https://bugzilla.kernel.org/show_bug.cgi?id=23282
+
+pthread_yield.3
+ Michael Kerrisk [Aristeu Rozanski]
+ Add _GNU_SOURCE feature test macro to SYNOPSIS
+
+resolver.3
+resolv.conf.5
+ Michael Kerrisk [Nathan Stratton Treadway, Simon Heimberg]
+ RES_DEBUG is only available if glibc is compiled with debug support
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=692136
+ and https://bugzilla.kernel.org/show_bug.cgi?id=43061
+
+strtol.3
+ Michael Kerrisk [Peter Schiffer]
+ Remove crufty text from previous fix
+
+core.5
+ Michael Kerrisk
+ Document CONFIG_COREDUMP
+
+capabilities.7
+ Andrey Vagin
+ Nonexistent bits are no longer shown as set in /proc/PID/status Cap*
+
+inotify.7
+ Michael Kerrisk
+ A monitoring process can't easily distinguish events triggered by itself
+
+ip.7
+ Flavio Leitner [Peter Schiffer]
+ Improve explanation about calling listen() or connect()
+
+man-pages.7
+ Michael Kerrisk
+ Describe rules for capitalization in .SS headings
+
+rtnetlink.7
+ Pavel Emelyanov
+ Add info about ability to create links with given index
+ Since kernel v3.7 the RTM_NEWLINK message now accepts nonzero
+ values in ifi_index field. Mention this fact in the respective
+ rtnetlink.7 section.
+
+socket.7
+ Pavel Emelyanov
+ SO_BINDTODEVICE is now readable
+ SO_BINDTODEVICE is readable since since kernel 3.8.