diff options
| -rw-r--r-- | Changes | 226 | ||||
| -rw-r--r-- | Changes.old | 226 |
2 files changed, 244 insertions, 208 deletions
@@ -1,6 +1,6 @@ -==================== Changes in man-pages-3.22 ==================== +==================== Changes in man-pages-3.23 ==================== -Released: 2009-07-25, Munich +Released: ????-??-??, Munich Contributors @@ -9,216 +9,26 @@ Contributors The following people contributed notes, ideas, or patches that have been incorporated in changes in this release: -Adrian Dewhurst <sailor@sailorfrag.net> -Alexander Lamaison <awl03@doc.ic.ac.uk> -Bryan �stergaard <kloeri@exherbo.org> -Christopher Head <chead@telus.net> -Doug Goldstein <cardoe@gentoo.org> -Florentin Duneau <fduneau@gmail.com> -Gokdeniz Karadag <gokdenizk@gmail.com> -Jeff Moyer <jmoyer@redhat.com> -KOSAKI Motohiro <kosaki.motohiro@jp.fujitsu.com> -Lucian Adrian Grijincu <lucian.grijincu@gmail.com> -Mark Hills <mark@pogo.org.uk> -Michael Kerrisk <mtk.manpages@gmail.com> -Mike Frysinger <vapier@gentoo.org> -Petr Baudis <pasky@suse.cz> -Reimar D�ffinger <Reimar.Doeffinger@gmx.de> -Ricardo Garcia <rg3.zeluan@gmail.com> -Rui Rlex <rui.rlex@gmail.com> -Shachar Shemesh <shachar@debian.org> -Tolga Dalman <tdalman@project-psi.org> -ku roi <kuroibox@yahoo.de> -sobtwmxt <sobtwmxt@sdf.lonestar.org> Apologies if I missed anyone! +New and rewritten pages +----------------------- + + +Newly documented interfaces in existing pages +--------------------------------------------- + + +New and changed links +--------------------- + + +Global changes +-------------- + + Changes to individual pages --------------------------- -clone.2 - Michael Kerrisk - Rewrite crufty text about number of args in older version of clone() - Some bit rot had crept in regarding the discussion of the - number of arguments in older versions of this syscall. - Simplify the text to just say that Linux 2.4 and earlier - didn't have ptid, tls, and ctid arguments. - - See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=533868 - Michael Kerrisk - Fix version number for CLONE_NEWIPC - It's 2.6.19, not 2.4.19. - Michael Kerrisk - Fix errors in argument names in text (ptid, ctd) - -execve.2 - Mike Frysinger - Remove erroneous statement that pending signal set is cleared - on execve(2). - -fcntl.2 - Michael Kerrisk - The kernel source file mandatory.txt is now mandatory-locking.txt - Michael Kerrisk - The Documentation/* files are now in Documentation/filesystems - -flock.2 - Michael Kerrisk - Remove unneeded reference to Documentation/mandatory.txt - Mandatory locks are only implemented by fcntl() locking - Michael Kerrisk - The Documentation/* files are now in Documentation/filesystems - -fork.2 - Jeff Moyer - Document fork() behaviour for the Linux native AIO io_context - It was noted on lkml that the fork behaviour is documented - for the POSIX AIO calls, but not for the Linux native calls. - Here is a patch which adds a small blurb that folks will - hopefully find useful. - - Upon fork(), the child process does not inherit the - io_context_t data structures returned by io_setup, - and thus cannot submit further asynchronous I/O or - reap event completions for said contexts. - -getdents.2 - Michael Kerrisk - The d_type field is fully supported on Btrfs - -mount.2 - Michael Kerrisk - Document MS_STRICTATIME, update description of MS_RELATIME - Starting with Linux 2.6.30, the MS_RELATIME behavior became - the default, and MS_STRICTATIME is required to obtain the - traditional semantics. - -poll.2 - Michael Kerrisk - Remove EBADF error from ERRORS - As reported by Motohiro: - - "man poll" describe this error code. - - >ERRORS - > EBADF An invalid file descriptor was given in one of the sets. - - but current kernel implementation ignore invalid file descriptor, - not return EBADF. - ... - - In the other hand, SUSv3 talk about - - > POLLNVAL - > The specified fd value is invalid. This flag is only valid in the - > revents member; it shall ignored in the events member. - - and - - > If the value of fd is less than 0, events shall be ignored, and - > ireevents shall be set to 0 in that entry on return from poll(). - - but, no desribe EBADF. - (see http://www.opengroup.org/onlinepubs/009695399/functions/poll.html) - - So, I think the implementation is correct. - - Why don't we remove EBADF description? - -sigaction.2 - Michael Kerrisk - EWxpand description of si_utime and si_stime fields of siginfo_t - -stat.2 - Michael Kerrisk - Improve wording of ENOTDIR error - -syscalls.2 - Michael Kerrisk - Ad preadv() and pwritev(), new in kernel 2.6.30 - -wait.2 - Gokdeniz Karadag - Document CLD_DUMPED and CLD_TRAPPED si_code values - -daemon.3 - Michael Kerrisk - Clarify discussion of 'noclose' and 'nochdir' arguments - -ffs.3 - Petr Baudis - SEE ALSO: add memchr(3) - -fmemopen.3 - Petr Baudis - Relocate BUGS section to correct position - Petr Baudis - NOTES: there is no file descriptor associated with the returned stream - Alexander Lamaison pointed out that this is not obvious - from the documentation, citing an example with passing the - FILE * handle to a function that tries to fstat() its - fileno() in order to determine the buffer size. - Michael Kerrisk - CONFORMING TO: remove note that these functions are GNU extensions - That sentence is now redundant, since these functions - are added in POSIX.1-2008. - -lockf.3 - Michael Kerrisk - Clarify relationship between fcntl() and lockf() locking - -memchr.3 - Petr Baudis - SEE ALSO: add ffs(3) - -readdir.3 - Michael Kerrisk - The d_type field is fully supported on Btrfs - -setjmp.3 - Mike Frysinger - Fix typo and clarify RETURN description - The word "signal" was duplicated in NOTES, and the RETURN - section refers to setjmp() and sigsetjmp(), and mentions - longjmp(), but not siglongjmp(). - -strcmp.3 - Petr Baudis - SEE ALSO: add strverscmp(3) - -strcpy.3 - Mark Hills - SEE ALSO: Add strdup(3) - -complex.7 - Michael Kerrisk - Add missing header file for example program - Reimar D�ffinger - Fix type used in example code - man complex (from release 3.18) contains the following code: - complex z = cexp(I * pi); - Reading the C99 standard, "complex" is not a valid type, - and several compilers (Intel ICC, ARM RVCT) will refuse to compile. - It should be - double complex z = cexp(I * pi); instead. - -environ.7 - Michael Kerrisk - Note that last element in environ array is NULL - See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=528628 - Michael Kerrisk - Wording fixes - -mq_overview.7 - Michael Kerrisk - Note that mkdir and mount commands here need superuser privilege - Michael Kerrisk - Fix example showing contents of /dev/mqueue file - -standards.7 - Michael Kerrisk - Remove references to dated books - Gallmeister and Lewine are rather old books. Probably, - there are better books to consult nowadays, and anyway, - this man page isn't intended to be a bibliography. diff --git a/Changes.old b/Changes.old index 47bb12c3b2..b491791b9c 100644 --- a/Changes.old +++ b/Changes.old @@ -18618,3 +18618,229 @@ feature_test_macros.7 ldconfig.8 Michael Kerrisk /etc/ld.so.conf also include libraries found in /lib and /usr/lib + + +==================== Changes in man-pages-3.22 ==================== + +Released: 2009-07-25, Munich + + +Contributors +------------ + +The following people contributed notes, ideas, or patches that have +been incorporated in changes in this release: + +Adrian Dewhurst <sailor@sailorfrag.net> +Alexander Lamaison <awl03@doc.ic.ac.uk> +Bryan �stergaard <kloeri@exherbo.org> +Christopher Head <chead@telus.net> +Doug Goldstein <cardoe@gentoo.org> +Florentin Duneau <fduneau@gmail.com> +Gokdeniz Karadag <gokdenizk@gmail.com> +Jeff Moyer <jmoyer@redhat.com> +KOSAKI Motohiro <kosaki.motohiro@jp.fujitsu.com> +Lucian Adrian Grijincu <lucian.grijincu@gmail.com> +Mark Hills <mark@pogo.org.uk> +Michael Kerrisk <mtk.manpages@gmail.com> +Mike Frysinger <vapier@gentoo.org> +Petr Baudis <pasky@suse.cz> +Reimar D�ffinger <Reimar.Doeffinger@gmx.de> +Ricardo Garcia <rg3.zeluan@gmail.com> +Rui Rlex <rui.rlex@gmail.com> +Shachar Shemesh <shachar@debian.org> +Tolga Dalman <tdalman@project-psi.org> +ku roi <kuroibox@yahoo.de> +sobtwmxt <sobtwmxt@sdf.lonestar.org> + +Apologies if I missed anyone! + + +Changes to individual pages +--------------------------- + +clone.2 + Michael Kerrisk + Rewrite crufty text about number of args in older version of clone() + Some bit rot had crept in regarding the discussion of the + number of arguments in older versions of this syscall. + Simplify the text to just say that Linux 2.4 and earlier + didn't have ptid, tls, and ctid arguments. + + See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=533868 + Michael Kerrisk + Fix version number for CLONE_NEWIPC + It's 2.6.19, not 2.4.19. + Michael Kerrisk + Fix errors in argument names in text (ptid, ctd) + +execve.2 + Mike Frysinger + Remove erroneous statement that pending signal set is cleared + on execve(2). + +fcntl.2 + Michael Kerrisk + The kernel source file mandatory.txt is now mandatory-locking.txt + Michael Kerrisk + The Documentation/* files are now in Documentation/filesystems + +flock.2 + Michael Kerrisk + Remove unneeded reference to Documentation/mandatory.txt + Mandatory locks are only implemented by fcntl() locking + Michael Kerrisk + The Documentation/* files are now in Documentation/filesystems + +fork.2 + Jeff Moyer + Document fork() behaviour for the Linux native AIO io_context + It was noted on lkml that the fork behaviour is documented + for the POSIX AIO calls, but not for the Linux native calls. + Here is a patch which adds a small blurb that folks will + hopefully find useful. + + Upon fork(), the child process does not inherit the + io_context_t data structures returned by io_setup, + and thus cannot submit further asynchronous I/O or + reap event completions for said contexts. + +getdents.2 + Michael Kerrisk + The d_type field is fully supported on Btrfs + +mount.2 + Michael Kerrisk + Document MS_STRICTATIME, update description of MS_RELATIME + Starting with Linux 2.6.30, the MS_RELATIME behavior became + the default, and MS_STRICTATIME is required to obtain the + traditional semantics. + +poll.2 + Michael Kerrisk + Remove EBADF error from ERRORS + As reported by Motohiro: + + "man poll" describe this error code. + + >ERRORS + > EBADF An invalid file descriptor was given in one of the sets. + + but current kernel implementation ignore invalid file descriptor, + not return EBADF. + ... + + In the other hand, SUSv3 talk about + + > POLLNVAL + > The specified fd value is invalid. This flag is only valid in the + > revents member; it shall ignored in the events member. + + and + + > If the value of fd is less than 0, events shall be ignored, and + > ireevents shall be set to 0 in that entry on return from poll(). + + but, no desribe EBADF. + (see http://www.opengroup.org/onlinepubs/009695399/functions/poll.html) + + So, I think the implementation is correct. + + Why don't we remove EBADF description? + +sigaction.2 + Michael Kerrisk + EWxpand description of si_utime and si_stime fields of siginfo_t + +stat.2 + Michael Kerrisk + Improve wording of ENOTDIR error + +syscalls.2 + Michael Kerrisk + Ad preadv() and pwritev(), new in kernel 2.6.30 + +wait.2 + Gokdeniz Karadag + Document CLD_DUMPED and CLD_TRAPPED si_code values + +daemon.3 + Michael Kerrisk + Clarify discussion of 'noclose' and 'nochdir' arguments + +ffs.3 + Petr Baudis + SEE ALSO: add memchr(3) + +fmemopen.3 + Petr Baudis + Relocate BUGS section to correct position + Petr Baudis + NOTES: there is no file descriptor associated with the returned stream + Alexander Lamaison pointed out that this is not obvious + from the documentation, citing an example with passing the + FILE * handle to a function that tries to fstat() its + fileno() in order to determine the buffer size. + Michael Kerrisk + CONFORMING TO: remove note that these functions are GNU extensions + That sentence is now redundant, since these functions + are added in POSIX.1-2008. + +lockf.3 + Michael Kerrisk + Clarify relationship between fcntl() and lockf() locking + +memchr.3 + Petr Baudis + SEE ALSO: add ffs(3) + +readdir.3 + Michael Kerrisk + The d_type field is fully supported on Btrfs + +setjmp.3 + Mike Frysinger + Fix typo and clarify RETURN description + The word "signal" was duplicated in NOTES, and the RETURN + section refers to setjmp() and sigsetjmp(), and mentions + longjmp(), but not siglongjmp(). + +strcmp.3 + Petr Baudis + SEE ALSO: add strverscmp(3) + +strcpy.3 + Mark Hills + SEE ALSO: Add strdup(3) + +complex.7 + Michael Kerrisk + Add missing header file for example program + Reimar D�ffinger + Fix type used in example code + man complex (from release 3.18) contains the following code: + complex z = cexp(I * pi); + Reading the C99 standard, "complex" is not a valid type, + and several compilers (Intel ICC, ARM RVCT) will refuse to compile. + It should be + double complex z = cexp(I * pi); instead. + +environ.7 + Michael Kerrisk + Note that last element in environ array is NULL + See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=528628 + Michael Kerrisk + Wording fixes + +mq_overview.7 + Michael Kerrisk + Note that mkdir and mount commands here need superuser privilege + Michael Kerrisk + Fix example showing contents of /dev/mqueue file + +standards.7 + Michael Kerrisk + Remove references to dated books + Gallmeister and Lewine are rather old books. Probably, + there are better books to consult nowadays, and anyway, + this man page isn't intended to be a bibliography. |