diff --git a/Changes b/Changes index 9c0d97cfa..50625a49d 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 -Aristeu Rozanski -Colin Walters -Cyril Hrubis -Cyrill Gorcunov -Daniel P. Berrange -David Prévot -D. Barbier -Denys Vlasenko -Flavio Leitner -Graham Gower -Ivana Varekova -Kai Kunschke -Marcela Maslanova -Marc Lehmann -Marshel Abraham -Michael Kerrisk -Nathan Stratton Treadway -Pavel Emelyanov -Peter Schiffer -Simon Heimberg -Simon Paillard -Török Edwin -Ulrich Drepper -Zack Weinberg 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 ca370e102..a7e58b747 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 +Aristeu Rozanski +Colin Walters +Cyril Hrubis +Cyrill Gorcunov +Daniel P. Berrange +David Prévot +D. Barbier +Denys Vlasenko +Flavio Leitner +Graham Gower +Ivana Varekova +Kai Kunschke +Marcela Maslanova +Marc Lehmann +Marshel Abraham +Michael Kerrisk +Nathan Stratton Treadway +Pavel Emelyanov +Peter Schiffer +Simon Heimberg +Simon Paillard +Török Edwin +Ulrich Drepper +Zack Weinberg + +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.