From d7628532af6d7076512d32f88799effb5456a6ff Mon Sep 17 00:00:00 2001 From: Michael Kerrisk Date: Sat, 11 Jan 2014 11:18:26 +1300 Subject: [PATCH] Start of man-pages-3.57: updating Changes and Changes.old --- Changes | 399 +----------------------------------------------- Changes.old | 432 ++++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 434 insertions(+), 397 deletions(-) diff --git a/Changes b/Changes index 5fef4a687..71acc3be9 100644 --- a/Changes +++ b/Changes @@ -1,8 +1,6 @@ -==================== Changes in man-pages-3.56 ==================== +==================== Changes in man-pages-3.57 ==================== -Released: 2014-01-11, Christchurch - -In memory of Doris Church (1939-2013) +Released: ????-??-??, Munich Contributors @@ -12,38 +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: -Andre Majorel -Arif Zaman -Bert Wesarg -Daniel Borkmann -David Malcolm -David Prévot -Dongsheng Song -Elie De Brauwer -James Smith -Janne Blomqvist -Joseph S. Myers -Luke Hutchison -Marco Dione -Mathieu Desnoyers -Mathieu Malaterre -Matthias Klose -Michael Kerrisk -Mike Frysinger -Moritz 'Morty' Strübe -Nadav Har'El -Ondřej Bílka -Prádraig Brady -Peng Haitao -Raphael Geissert -Shawn Landden -Simon Paillard -Stephen Kell -Sudhanshu Goswami -Sworddragon2 -Vince Weaver -Willem de Bruijn -Yuri Kozlov Apologies if I missed anyone! @@ -51,380 +17,19 @@ Apologies if I missed anyone! New and rewritten pages ----------------------- -fgetc.3 -gets.3 - David Malcolm - Split gets(3) to isolate unsafe gets(3) to a page on its own - Currently man3/gets.3 documents various safe I/O functions, along - with the toxic "gets" function. - - At the risk of being melodramatic, this strikes me as akin to - storing rat poison in a food cabinet, in the same style of - packaging as the food, but with a post-it note on it saying - "see warnings below". - - I think such "never use this" functions should be quarantined - into their own manpages, rather than listing them alongside - sane functions. - - The attached patch does this for "gets", moving the documentation - of the good functions from man3/gets.3 into man3/fgetc.3, - updating the SO links in the relevant functions to point at the - latter. - - It then rewrites man3/gets.3 to spell out that "gets" is toxic - and should never be used (with a link to CWE-242 for good - measure). - Michael Kerrisk [Andre Majorel] - Tweaks to David Malcolm's patch - -vdso.7 - Mike Frysinger - New page documenting the vDSO mapped into each process by the kernel - Newly documented interfaces in existing pages --------------------------------------------- -reboot.2 - Elie De Brauwer - Document LINUX_REBOOT_SW_SUSPEND - New and changed links --------------------- -fgets.3 -getc.3 -getchar.3 -ungetc.3 - Michael Kerrisk - Adjust links to gets(3) to point to fgetc(3) - Global changes -------------- -Various pages - Michael Kerrisk - Global fix of "NULL pointer" - Change "NULL pointer" to "NULL" or null pointer". - POSIX uses the term "null pointer", not "NULL pointer". - -Various pages - Michael Kerrisk - Stylistic changes to code example - For ease of reading, don't embed assignments inside if(). - -Various pages - Michael Kerrisk - Replace uses of "i.e.," in main text with "that is" or similar - Usual man-pages style is to use "i.e." only within - parenthetical expressions. - -Various pages - Michael Kerrisk - Replace uses of "e.g." in main text with "for example" or similar - Usual man-pages style is to use "e.g." only within - parenthetical expressions. - -Various pages - Michael Kerrisk - Add "Program source" subheading under EXAMPLE - -Various pages - Michael Kerrisk - Add "static" to global variables and functions in example program - Changes to individual pages --------------------------- -clock_getres.2 - Michael Kerrisk [Nadav Har'El] - Improve description of CLOCK_PROCESS_CPUTIME_ID - See https://bugzilla.kernel.org/show_bug.cgi?id=67291 - -close.2 - Michael Kerrisk [P?draig Brady] - Note that errors from close() should be used only for diagnosis - In particular, retrying after EINTR is a bad idea. - - See http://austingroupbugs.net/view.php?id=529 - - See http://thread.gmane.org/gmane.comp.lib.glibc.alpha/37702 - Subject: [RFC][BZ #14627] Make linux close errno to EINPROGRESS - when interrupted in signal. - -execve.2 - Michael Kerrisk [Marco Dione] - Add further cases to EFAULT error - See https://sourceware.org/bugzilla/show_bug.cgi?id=16402 - -perf_event_open.2 - Vince Weaver [Sudhanshu Goswami] - Clarify issues with the disabled bit - Clarify the perf_event_open behavior with respect to the disabled - bit and creating event groups. - Vince Weaver [Sudhanshu Goswami] - Clarify issues with the exclusive bit - Warn that using the perf_event_open "exclusive" bit, while - it might seem like a good idea, might lead to all 0 results - in some common usage cases. - -reboot.2 - Elie De Brauwer - Mention RB_POWER_OFF - The manpage did not mention RB_POWER_OFF which is the glibc - symbolic name for LINUX_REBOOT_CMD_POWER_OFF. - - $ cd /usr/include - $ cat x86_64-linux-gnu/sys/reboot.h | grep POWER_OFF - define RB_POWER_OFF 0x4321fedc - Elie De Brauwer - Add "Linux" to kernel version numbers - Michael Kerrisk - Add RB_SW_SUSPEND synonym - Michael Kerrisk - Add RB_KEXEC synonym - -setpgid.2 - Michael Kerrisk [Joseph S. Myers] - BSD getpgrp() and setpgrp() go away in glibc 2.19 -socket.2 - Michael Kerrisk [Dongsheng Song] - Remove crufty statement that AF_INET does not support SOCK_SEQPACKET - Linux AF_INET supports SOCK_SEQPACKET via SCTP. - -syscall.2 - Mike Frysinger - Fix ia64 registers - The original list of registers was created by confusing strace - source code--this is for parsing legacy 32-bit code (which is - dead and no one cares). Update the list to reflect native ia64 - syscall interface. - -syscall.2 -syscalls.2 -getauxval.3 - Mike Frysinger - Add references to new vdso(7) page - -utimensat.2 - Michael Kerrisk - Small wording improvement for times!=NULL case - -dlopen.3 - Michael Kerrisk [Mike Frysinger] - Update remarks on cast needed when assigning dlsym() return value - POSIX.1-2013 eases life when casting the dlsym() return value to a - function pointer - Michael Kerrisk [Stephen Kell] - Fix description of dli_sname - See https://sourceware.org/bugzilla/show_bug.cgi?id=16262 - -getline.3 - Michael Kerrisk [Luke Hutchison] - Correct description of how '*n' is used when '*lineptr' == NULL - See https://sourceware.org/bugzilla/show_bug.cgi?id=5468 - Michael Kerrisk - Remove SEE ALSO reference to unsafe gets(3) - -mcheck.3 - Simon Paillard [Raphael Geissert] - typo in compiler flag - See http://bugs.debian.org/732464 - -mkstemp.3 - Michael Kerrisk [Janne Blomqvist] - Better describe 'flags' that can be specified for mkostemp() - -printf.3 - Michael Kerrisk [Arif Zaman] - Fix memory leak in snprintf() example - See http://stackoverflow.com/questions/19933479/snprintf-man-page-example-memory-leak - -pthread_kill.3 - Michael Kerrisk [Mathieu Desnoyers] - POSIX.1-2008 removes ESRCH - POSIX.1-2001 mistakenly documented an ESRCH error, and - POSIX.1-2008 removes this error. Glibc does return - this error in cases where it can determine that a thread ID - is invalid, but equally, the use of an invalid thread ID - can cause a segmentation fault. - -puts.3 - Michael Kerrisk - SEE ALSO: replace reference to gets(3) with fgets(3) - -scanf.3 - Michael Kerrisk [Ondřej Bílka] - Improve discussion of obsolete 'a' dynamic allocation modifier - -setjmp.3 - Michael Kerrisk [Joseph S. Myers] - BSD setjmp() semantics go away in glibc 2.19 - -sigpause.3 - Michael Kerrisk [Joseph S. Myers] - BSD sigpause() goes away in glibc 2.19 - Michael Kerrisk - Correct feature text macro requirements - Peng Haitao - ATTRIBUTES: Note function that is thread-safe - The function sigpause() is thread safe. - -sigqueue.3 - Peng Haitao - ATTRIBUTES: Note function that is thread-safe - The function sigqueue() is thread safe. - -sigwait.3 - Peng Haitao - ATTRIBUTES: Note function that is thread-safe - The function sigwait() is thread safe. - -sin.3 - Peng Haitao - ATTRIBUTES: Note functions that are thread-safe - The functions sin(), sinf() and sinl() are thread safe. - -sincos.3 - Peng Haitao - ATTRIBUTES: Note functions that are thread-safe - The functions sincos(), sincosf() and sincosl() are thread safe. - -string.3 - Moritz 'Morty' Strübe - Add short description of the functions - It is helpful to have a short description about what the different - functions in string.h do. - Michael Kerrisk - Fixes and enhancements to Moritz Strübe's patch - -strptime.3 - Michael Kerrisk [Mathieu Malaterre, Simon Paillard] - Add number ranges to comments in 'tm' structure - See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=729570 - Michael Kerrisk - Point to ctime(3) for more details on 'tm' structure - Michael Kerrisk - Some rewording and reorganization - -strsep.3 - Michael Kerrisk - Clarify description - The use of "symbols" in the existing description is confusing; - it's "bytes". Other fixes as well. - -strspn.3 - Michael Kerrisk [Mathieu Malaterre] - Improve description in NAME - See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=723659 - -strstr.3 - Michael Kerrisk - Clarify RETURN VALUE: s/substring/located substring/ - -sysv_signal.3 - Peng Haitao - ATTRIBUTES: Note function that is thread-safe - The function sysv_signal() is thread safe. - -tan.3 - Peng Haitao - ATTRIBUTES: Note functions that are thread-safe - The functions tan(), tanf() and tanl() are thread safe. - -tanh.3 - Peng Haitao - ATTRIBUTES: Note functions that are thread-safe - The functions tanh(), tanhf() and tanhl() are thread safe. - -toascii.3 - Peng Haitao - ATTRIBUTES: Note function that is thread-safe - The function toascii() is thread safe. - -toupper.3 - Peng Haitao - ATTRIBUTES: Note functions that are thread safe with exceptions - The functions toupper() and tolower() are thread safe with - exceptions. - -towctrans.3 - Peng Haitao - ATTRIBUTES: Note function that is thread-safe - The function towctrans() is thread safe. - -towlower.3 - Peng Haitao - ATTRIBUTES: Note function that is thread safe with exceptions - The function towlower() is thread safe with exceptions. - -towupper.3 - Peng Haitao - ATTRIBUTES: Note function that is thread safe with exceptions - The function towupper() is thread safe with exceptions. - -ualarm.3 - Peng Haitao - ATTRIBUTES: Note function that is thread-safe - The function ualarm() is thread safe. - -wcpncpy.3 - Peng Haitao - ATTRIBUTES: Note function that is thread-safe - The function wcpncpy() is thread safe. - -proc.5 - Michael Kerrisk [Sworddragon2] - Fix formula for CommitLimit under /proc/meminfo - See https://bugzilla.kernel.org/show_bug.cgi?id=60991 - -credentials.7 - Michael Kerrisk - List APIs that operate on process groups - Michael Kerrisk - Add details on controlling terminal and foreground/background jobs - -feature_test_macros.7 - Michael Kerrisk - Document _DEFAULT_SOURCE - Michael Kerrisk [Joseph S. Myers] - From glibc 2.19, _BSD_SOURCE no longer causes __FAVOR_BSD - Starting with glibc 2.19, _BSD_SOURCE no longer causes BSD - definitions to be favored in cases where standards conflict. - -libc.7 - Mike Frysinger - SEE ALSO: add various entries - -man-pages.7 - Michael Kerrisk [Mike Frysinger] - Add STYLE GUIDE section - Incorporate some of the existing material in the page - into the STYLE GUIDE, and add a lot more material, mainly - drawn from the "Global changes" sections in the release - changelogs. - Michael Kerrisk - Add historical note on reason for use of American spelling - Michael Kerrisk [Mike Frysinger] - Various improvements to style guide - -packet.7 - Willem de Bruijn [Daniel Borkmann] - Document fanout, ring, and auxiliary options - This patch adds descriptions of the common packet socket options - PACKET_AUXDATA, PACKET_FANOUT, PACKET_RX_RING, PACKET_STATISTICS, - PACKET_TX_RING - and the ring-specific options - PACKET_LOSS, PACKET_RESERVE, PACKET_TIMESTAMP, PACKET_VERSION - Michael Kerrisk - Add kernel version numbers for PACKET_VERSION and PACKET_TIMESTAMP - -ld.so.8 - Michael Kerrisk [Matthias Klose] - Default output file for D_DEBUG is stderr not stdout - See https://sourceware.org/bugzilla/show_bug.cgi?id=6874 - diff --git a/Changes.old b/Changes.old index 2caeccd20..9a71d39fb 100644 --- a/Changes.old +++ b/Changes.old @@ -28489,3 +28489,435 @@ tcp.7 ld.so.8 Michael Kerrisk [Alfred Agrell] Fix crufty wording in one sentence + + +==================== Changes in man-pages-3.56 ==================== + +Released: 2014-01-11, Christchurch + +In memory of Doris Church (1939-2013) + + +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: + +Andre Majorel +Arif Zaman +Bert Wesarg +Daniel Borkmann +David Malcolm +David Prévot +Dongsheng Song +Elie De Brauwer +James Smith +Janne Blomqvist +Joseph S. Myers +Luke Hutchison +Marco Dione +Mathieu Desnoyers +Mathieu Malaterre +Matthias Klose +Michael Kerrisk +Mike Frysinger +Moritz 'Morty' Strübe +Nadav Har'El +Ondřej Bílka +Prádraig Brady +Peng Haitao +Raphael Geissert +Shawn Landden +Simon Paillard +Stephen Kell +Sudhanshu Goswami +Sworddragon2 +Vince Weaver +Willem de Bruijn +Yuri Kozlov + +Apologies if I missed anyone! + + +New and rewritten pages +----------------------- + +fgetc.3 +gets.3 + David Malcolm + Split gets(3) to isolate unsafe gets(3) to a page on its own + Currently man3/gets.3 documents various safe I/O functions, along + with the toxic "gets" function. + + At the risk of being melodramatic, this strikes me as akin to + storing rat poison in a food cabinet, in the same style of + packaging as the food, but with a post-it note on it saying + "see warnings below". + + I think such "never use this" functions should be quarantined + into their own manpages, rather than listing them alongside + sane functions. + + The attached patch does this for "gets", moving the documentation + of the good functions from man3/gets.3 into man3/fgetc.3, + updating the SO links in the relevant functions to point at the + latter. + + It then rewrites man3/gets.3 to spell out that "gets" is toxic + and should never be used (with a link to CWE-242 for good + measure). + Michael Kerrisk [Andre Majorel] + Tweaks to David Malcolm's patch + +vdso.7 + Mike Frysinger + New page documenting the vDSO mapped into each process by the kernel + + +Newly documented interfaces in existing pages +--------------------------------------------- + +reboot.2 + Elie De Brauwer + Document LINUX_REBOOT_SW_SUSPEND + + +New and changed links +--------------------- + +fgets.3 +getc.3 +getchar.3 +ungetc.3 + Michael Kerrisk + Adjust links to gets(3) to point to fgetc(3) + + +Global changes +-------------- + +Various pages + Michael Kerrisk + Global fix of "NULL pointer" + Change "NULL pointer" to "NULL" or null pointer". + POSIX uses the term "null pointer", not "NULL pointer". + +Various pages + Michael Kerrisk + Stylistic changes to code example + For ease of reading, don't embed assignments inside if(). + +Various pages + Michael Kerrisk + Replace uses of "i.e.," in main text with "that is" or similar + Usual man-pages style is to use "i.e." only within + parenthetical expressions. + +Various pages + Michael Kerrisk + Replace uses of "e.g." in main text with "for example" or similar + Usual man-pages style is to use "e.g." only within + parenthetical expressions. + +Various pages + Michael Kerrisk + Add "Program source" subheading under EXAMPLE + +Various pages + Michael Kerrisk + Add "static" to global variables and functions in example program + + +Changes to individual pages +--------------------------- + +clock_getres.2 + Michael Kerrisk [Nadav Har'El] + Improve description of CLOCK_PROCESS_CPUTIME_ID + See https://bugzilla.kernel.org/show_bug.cgi?id=67291 + +close.2 + Michael Kerrisk [P?draig Brady] + Note that errors from close() should be used only for diagnosis + In particular, retrying after EINTR is a bad idea. + + See http://austingroupbugs.net/view.php?id=529 + + See http://thread.gmane.org/gmane.comp.lib.glibc.alpha/37702 + Subject: [RFC][BZ #14627] Make linux close errno to EINPROGRESS + when interrupted in signal. + +execve.2 + Michael Kerrisk [Marco Dione] + Add further cases to EFAULT error + See https://sourceware.org/bugzilla/show_bug.cgi?id=16402 + +perf_event_open.2 + Vince Weaver [Sudhanshu Goswami] + Clarify issues with the disabled bit + Clarify the perf_event_open behavior with respect to the disabled + bit and creating event groups. + Vince Weaver [Sudhanshu Goswami] + Clarify issues with the exclusive bit + Warn that using the perf_event_open "exclusive" bit, while + it might seem like a good idea, might lead to all 0 results + in some common usage cases. + +reboot.2 + Elie De Brauwer + Mention RB_POWER_OFF + The manpage did not mention RB_POWER_OFF which is the glibc + symbolic name for LINUX_REBOOT_CMD_POWER_OFF. + + $ cd /usr/include + $ cat x86_64-linux-gnu/sys/reboot.h | grep POWER_OFF + define RB_POWER_OFF 0x4321fedc + Elie De Brauwer + Add "Linux" to kernel version numbers + Michael Kerrisk + Add RB_SW_SUSPEND synonym + Michael Kerrisk + Add RB_KEXEC synonym + +setpgid.2 + Michael Kerrisk [Joseph S. Myers] + BSD getpgrp() and setpgrp() go away in glibc 2.19 +socket.2 + Michael Kerrisk [Dongsheng Song] + Remove crufty statement that AF_INET does not support SOCK_SEQPACKET + Linux AF_INET supports SOCK_SEQPACKET via SCTP. + +syscall.2 + Mike Frysinger + Fix ia64 registers + The original list of registers was created by confusing strace + source code--this is for parsing legacy 32-bit code (which is + dead and no one cares). Update the list to reflect native ia64 + syscall interface. + +syscall.2 +syscalls.2 +getauxval.3 + Mike Frysinger + Add references to new vdso(7) page + +utimensat.2 + Michael Kerrisk + Small wording improvement for times!=NULL case + +dlopen.3 + Michael Kerrisk [Mike Frysinger] + Update remarks on cast needed when assigning dlsym() return value + POSIX.1-2013 eases life when casting the dlsym() return value to a + function pointer + Michael Kerrisk [Stephen Kell] + Fix description of dli_sname + See https://sourceware.org/bugzilla/show_bug.cgi?id=16262 + +getline.3 + Michael Kerrisk [Luke Hutchison] + Correct description of how '*n' is used when '*lineptr' == NULL + See https://sourceware.org/bugzilla/show_bug.cgi?id=5468 + Michael Kerrisk + Remove SEE ALSO reference to unsafe gets(3) + +mcheck.3 + Simon Paillard [Raphael Geissert] + typo in compiler flag + See http://bugs.debian.org/732464 + +mkstemp.3 + Michael Kerrisk [Janne Blomqvist] + Better describe 'flags' that can be specified for mkostemp() + +printf.3 + Michael Kerrisk [Arif Zaman] + Fix memory leak in snprintf() example + See http://stackoverflow.com/questions/19933479/snprintf-man-page-example-memory-leak + +pthread_kill.3 + Michael Kerrisk [Mathieu Desnoyers] + POSIX.1-2008 removes ESRCH + POSIX.1-2001 mistakenly documented an ESRCH error, and + POSIX.1-2008 removes this error. Glibc does return + this error in cases where it can determine that a thread ID + is invalid, but equally, the use of an invalid thread ID + can cause a segmentation fault. + +puts.3 + Michael Kerrisk + SEE ALSO: replace reference to gets(3) with fgets(3) + +scanf.3 + Michael Kerrisk [Ondřej Bílka] + Improve discussion of obsolete 'a' dynamic allocation modifier + +setjmp.3 + Michael Kerrisk [Joseph S. Myers] + BSD setjmp() semantics go away in glibc 2.19 + +sigpause.3 + Michael Kerrisk [Joseph S. Myers] + BSD sigpause() goes away in glibc 2.19 + Michael Kerrisk + Correct feature text macro requirements + Peng Haitao + ATTRIBUTES: Note function that is thread-safe + The function sigpause() is thread safe. + +sigqueue.3 + Peng Haitao + ATTRIBUTES: Note function that is thread-safe + The function sigqueue() is thread safe. + +sigwait.3 + Peng Haitao + ATTRIBUTES: Note function that is thread-safe + The function sigwait() is thread safe. + +sin.3 + Peng Haitao + ATTRIBUTES: Note functions that are thread-safe + The functions sin(), sinf() and sinl() are thread safe. + +sincos.3 + Peng Haitao + ATTRIBUTES: Note functions that are thread-safe + The functions sincos(), sincosf() and sincosl() are thread safe. + +string.3 + Moritz 'Morty' Strübe + Add short description of the functions + It is helpful to have a short description about what the different + functions in string.h do. + Michael Kerrisk + Fixes and enhancements to Moritz Strübe's patch + +strptime.3 + Michael Kerrisk [Mathieu Malaterre, Simon Paillard] + Add number ranges to comments in 'tm' structure + See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=729570 + Michael Kerrisk + Point to ctime(3) for more details on 'tm' structure + Michael Kerrisk + Some rewording and reorganization + +strsep.3 + Michael Kerrisk + Clarify description + The use of "symbols" in the existing description is confusing; + it's "bytes". Other fixes as well. + +strspn.3 + Michael Kerrisk [Mathieu Malaterre] + Improve description in NAME + See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=723659 + +strstr.3 + Michael Kerrisk + Clarify RETURN VALUE: s/substring/located substring/ + +sysv_signal.3 + Peng Haitao + ATTRIBUTES: Note function that is thread-safe + The function sysv_signal() is thread safe. + +tan.3 + Peng Haitao + ATTRIBUTES: Note functions that are thread-safe + The functions tan(), tanf() and tanl() are thread safe. + +tanh.3 + Peng Haitao + ATTRIBUTES: Note functions that are thread-safe + The functions tanh(), tanhf() and tanhl() are thread safe. + +toascii.3 + Peng Haitao + ATTRIBUTES: Note function that is thread-safe + The function toascii() is thread safe. + +toupper.3 + Peng Haitao + ATTRIBUTES: Note functions that are thread safe with exceptions + The functions toupper() and tolower() are thread safe with + exceptions. + +towctrans.3 + Peng Haitao + ATTRIBUTES: Note function that is thread-safe + The function towctrans() is thread safe. + +towlower.3 + Peng Haitao + ATTRIBUTES: Note function that is thread safe with exceptions + The function towlower() is thread safe with exceptions. + +towupper.3 + Peng Haitao + ATTRIBUTES: Note function that is thread safe with exceptions + The function towupper() is thread safe with exceptions. + +ualarm.3 + Peng Haitao + ATTRIBUTES: Note function that is thread-safe + The function ualarm() is thread safe. + +wcpncpy.3 + Peng Haitao + ATTRIBUTES: Note function that is thread-safe + The function wcpncpy() is thread safe. + +proc.5 + Michael Kerrisk [Sworddragon2] + Fix formula for CommitLimit under /proc/meminfo + See https://bugzilla.kernel.org/show_bug.cgi?id=60991 + +credentials.7 + Michael Kerrisk + List APIs that operate on process groups + Michael Kerrisk + Add details on controlling terminal and foreground/background jobs + +feature_test_macros.7 + Michael Kerrisk + Document _DEFAULT_SOURCE + Michael Kerrisk [Joseph S. Myers] + From glibc 2.19, _BSD_SOURCE no longer causes __FAVOR_BSD + Starting with glibc 2.19, _BSD_SOURCE no longer causes BSD + definitions to be favored in cases where standards conflict. + +libc.7 + Mike Frysinger + SEE ALSO: add various entries + +man-pages.7 + Michael Kerrisk [Mike Frysinger] + Add STYLE GUIDE section + Incorporate some of the existing material in the page + into the STYLE GUIDE, and add a lot more material, mainly + drawn from the "Global changes" sections in the release + changelogs. + Michael Kerrisk + Add historical note on reason for use of American spelling + Michael Kerrisk [Mike Frysinger] + Various improvements to style guide + +packet.7 + Willem de Bruijn [Daniel Borkmann] + Document fanout, ring, and auxiliary options + This patch adds descriptions of the common packet socket options + PACKET_AUXDATA, PACKET_FANOUT, PACKET_RX_RING, PACKET_STATISTICS, + PACKET_TX_RING + and the ring-specific options + PACKET_LOSS, PACKET_RESERVE, PACKET_TIMESTAMP, PACKET_VERSION + Michael Kerrisk + Add kernel version numbers for PACKET_VERSION and PACKET_TIMESTAMP + +ld.so.8 + Michael Kerrisk [Matthias Klose] + Default output file for D_DEBUG is stderr not stdout + See https://sourceware.org/bugzilla/show_bug.cgi?id=6874 +