diff --git a/Changes b/Changes index 9939fa45c..d059d55af 100644 --- a/Changes +++ b/Changes @@ -1,6 +1,6 @@ -==================== Changes in man-pages-3.27 ==================== +==================== Changes in man-pages-3.28 ==================== -Released: 2010-09-22, Nuernberg +Released: ????-??-??, Munich Contributors @@ -9,24 +9,6 @@ Contributors The following people contributed notes, ideas, or patches that have been incorporated in changes in this release: -caishuxian@gmail.com -Denis Barbier -Denis Silakov -der Mouse -Jan Kratochvil -Jim Belton -Jiri Olsa -KOSAKI Motohiro -Mark Hills -Matthew Flaschen -Michael Kerrisk -Ozgur Gurcan -Petr Baudis -Remi Denis-Courmont -Tanaka Akira -Tim Stoakes -W. Trevor King -Yuri Kozlov Apologies if I missed anyone! @@ -34,473 +16,19 @@ Apologies if I missed anyone! New and rewritten pages ----------------------- -sigevent.7 - Petr Baudis, Michael Kerrisk - New page to centralize description of sigevent structure - Several interfaces use this structure. Best to centralize the - common details in one place. Content taken from the existing - timerfd_create.2 and mq_open.3 pages, with additions by - Petr Baudis and Michael Kerrisk. - Newly documented interfaces in existing pages --------------------------------------------- +New and changed links +--------------------- + + Global changes -------------- -_exit.2 -brk.2 -chdir.2 -chmod.2 -chown.2 -chroot.2 -clock_nanosleep.2 -getdtablesize.2 -gethostname.2 -getpagesize.2 -getsid.2 -killpg.2 -mknod.2 -mknodat.2 -posix_fadvise.2 -pread.2 -readlink.2 -setpgid.2 -setpgid.2 -setreuid.2 -sigaltstack.2 -stat.2 -symlink.2 -sync.2 -truncate.2 -vfork.2 -wait.2 -wait4.2 -a64l.3 -abs.3 -acos.3 -acosh.3 -asin.3 -asinh.3 -atan.3 -atan2.3 -atanh.3 -atoi.3 -cbrt.3 -ceil.3 -clock_getcpuclockid.3 -copysign.3 -cos.3 -cosh.3 -dirfd.3 -div.3 -dprintf.3 -ecvt.3 -erf.3 -erfc.3 -exp.3 -exp2.3 -expm1.3 -fabs.3 -fdim.3 -fexecve.3 -ffs.3 -floor.3 -fma.3 -fmax.3 -fmemopen.3 -fmin.3 -fmod.3 -fpclassify.3 -frexp.3 -fwide.3 -gamma.3 -gcvt.3 -getcwd.3 -getdate.3 -getgrent.3 -gethostid.3 -getpass.3 -getpwent.3 -getsubopt.3 -getw.3 -hypot.3 -ilogb.3 -insque.3 -isalpha.3 -isgreater.3 -iswblank.3 -j0.3 -j0.3 -ldexp.3 -lockf.3 -log.3 -log10.3 -log1p.3 -log2.3 -logb.3 -lrint.3 -lround.3 -mbsnrtowcs.3 -mkdtemp.3 -mkstemp.3 -mktemp.3 -modf.3 -mq_receive.3 -mq_send.3 -nan.3 -nextafter.3 -posix_fallocate.3 -posix_memalign.3 -pow.3 -printf.3 -qecvt.3 -random.3 -realpath.3 -remainder.3 -remquo.3 -rint.3 -rint.3 -round.3 -scalb.3 -scalbln.3 -scanf.3 -siginterrupt.3 -signbit.3 -sigset.3 -sin.3 -sinh.3 -sqrt.3 -stpcpy.3 -stpncpy.3 -strdup.3 -strdup.3 -strnlen.3 -strsignal.3 -strtod.3 -strtol.3 -strtoul.3 -tan.3 -tanh.3 -tgamma.3 -trunc.3 -ttyslot.3 -ualarm.3 -usleep.3 -wcpcpy.3 -wcpncpy.3 -wcscasecmp.3 -wcsdup.3 -wcsncasecmp.3 -wcsnlen.3 -wcsnrtombs.3 -wprintf.3 - Michael Kerrisk - Add/fix/update feature test macro requirements in SYNOPSIS - Various changes to: - * Update feature test requirements to note changes in - recent glibc releases - * Correct errors in feature test macro requirements - * Add feature test macro requirements to pages where - the requirements were not previously stated. - -accept.2 -clone.2 -dup.2 -fallocate.2 -pipe.2 -readahead.2 -sched_setaffinity.2 -unshare.2 -CPU_SET.3 -endian.3 -euidaccess.3 -fexecve.3 -getpt.3 -getpw.3 -getumask.3 -getutmp.3 -gnu_get_libc_version.3 -makedev.3 -matherr.3 -mbsnrtowcs.3 -memfrob.3 -pthread_attr_setaffinity_np.3 -pthread_getattr_np.3 -pthread_setaffinity_np.3 -pthread_tryjoin_np.3 -tcgetsid.3 -wcscasecmp.3 -wcsncasecmp.3 -wcsnlen.3 -wcsnrtombs.3 -wcswidth.3 -rtld-audit.7 - Michael Kerrisk - SYNOPSIS: Add reference to feature_test_macros(7) - These pages specify feature test macros in the function - prototypes. Add a reference to feature_test_macros(7), - so that readers are pointed to the information that - feature test macros must be defined before including - *any* header file. - -clock_nanosleep.2 -clock_getcpuclockid.3 -getnetent_r.3 -getprotoent_r.3 -getrpcent_r.3 -getservent_r.3 -sigwait.3 - Michael Kerrisk - RETURN VALUE: Note that "positive error numbers" are listed in ERRORS - -fcntl.2 -intro.2 -open.2 -poll.2 -ftw.3 -intro.3 -matherr.3 -system.3 -tmpnam.3 -unix.7 - Michael Kerrisk - Note that feature test macros must be defined before *any* includes - Programmers often make the mistake of including a feature test - macro only after having already included some header files. - This patch adds some text at opportune places to remind - programmers to do things the right way. - -index.3 -stpcpy.3 -strcasecmp.3 -strcat.3 -strchr.3 -strcmp.3 -strcoll.3 -strcpy.3 -strdup.3 -strfry.3 -strpbrk.3 -strsep.3 -strspn.3 -strstr.3 -strtok.3 -strxfrm.3 - Michael Kerrisk - SEE ALSO: Add reference to string(3) - The idea here is to provide a route to discover other - string functions. - -armscii-8.7 -cp1251.7 -iso_8859-3.7 -iso_8859-5.7 -iso_8859-6.7 -iso_8859-8.7 -iso_8859-10.7 -iso_8859-11.7 -iso_8859-13.7 -iso_8859-14.7 -koi8-u.7 - Denis Barbier - Fix decimal values in encoding tables - Octal and hexadecimal values are right, but there are some - off-by one errors in decimal values. Correct values are - printed by this command: - - perl -pi -e 'if (s/^([0-7]+)\t([0-9]+)\t([0-9a-fA-F]+)//) - {printf "%03o\t%d\t%s", hex($3), hex($3), $3;};' man7/*.7 - Changes to individual pages --------------------------- -capget.2 - Michael Kerrisk - SYNOPSIS: Remove unneeded "undef _POSIX_SOURCE" - -fcntl.2 - Michael Kerrisk - Add feature test macro requirements for F_GETOWN and F_SETOWN - -fcntl.2 - Michael Kerrisk - Note feature test macro requirements for F_DUPFD_CLOEXEC - -getrlimit.2 - Michael Kerrisk - Document units for RLIMIT_RTTIME limit - This limit is in microseconds - - http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=596492 - -lseek.2 - Michael Kerrisk - Removed note about return type on ancient systems - -mount.2 - Michael Kerrisk - Definitions of various MS_* constants only appeared in glibc 2.12 - See http://sourceware.org/bugzilla/show_bug.cgi?id=11235 - -stat.2 - Michael Kerrisk - Update information on nanosecond timestamp fields - Update feature test macro requirements for exposing these fields. - Note that these fields are specified in POSIX.1-2008. - -timer_create.2 - Michael Kerrisk - Factor out generic material that was moved to new sigevent(7) page - -aio_fsync.3 - Michael Kerrisk - Add reference to new sigevent(7) page - -atanh.3 - Michael Kerrisk - glibc 2.10 fixed pole error bug - http://sourceware.org/bugzilla/show_bug.cgi?id=6759 - was resolved. - -cerf.3 - Michael Kerrisk - Make it clearer that this function is unimplemented - -cos.3 - Michael Kerrisk - errno is now correctly set to EDOM on a domain error - http://sources.redhat.com/bugzilla/show_bug.cgi?id=6780 - was (silently) resolved. - -expm1.3 - Michael Kerrisk - errno is now correctly set to ERANGE on a range error - http://sources.redhat.com/bugzilla/show_bug.cgi?id=6788 - was (silently) resolved. - -fmod.3 - Michael Kerrisk - errno is now correctly set to EDOM for the x==inf domain error - http://sources.redhat.com/bugzilla/show_bug.cgi?id=6784 - was (silently) resolved. - -insque.3 - Michael Kerrisk - Noted prev == NULL bug in glibc 2.4 and earlier - As noted by Remi Denis-Courmont, glibc nowadays allows - 'prev' to be NULL, as required by POSIX for initializing - a linear list. But in glibc 2.4 and earlier, 'prev' could - not be NULL. Add a BUGS section noting this. - - See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=551201 - -insque.3 - Michael Kerrisk - Added info on circular lists, and initializing circular lists - Michael Kerrisk - Added example program - -lgamma.3 - Michael Kerrisk - glibc 2.10 fixed pole error bug - http://sourceware.org/bugzilla/show_bug.cgi?id=6777 - was (silently) resolved. - -log2.3 - Matthew Flaschen - log2() function does not conform to C89 - log2(), log2f(), and log2l() do not conform to C89. - They are defined in C99. See http://flash-gordon.me.uk/ansi.c.txt - and http://www.schweikhardt.net/identifiers.html - -mq_notify.3 - Michael Kerrisk - Factor out generic material that was moved to new sigevent(7) page - -pow.3 - Michael Kerrisk - errno is now correctly set to ERANGE on a pole error - http://sources.redhat.com/bugzilla/show_bug.cgi?id=6776 - was (silently) resolved. - -pthread_kill_other_threads_np.3 - Michael Kerrisk - CONFORMING TO: Note meaning of "_np" suffix - -rand.3 - Michael Kerrisk - Clarify description of range of returned value - Michael Kerrisk - Add an example program - Michael Kerrisk - Expand description of rand_r() - -random.3 - W. Trevor King - Update initstate() return value description to match glibc - -readdir.3 - Michael Kerrisk - Clarify that "positive error numbers" are listed in ERRORS - Reported-by fkater@googlemail.com - -rexec.3 - Michael Kerrisk - SYNOPSIS: Add header file and feature test macro requirements - -sigpause.3 - Michael Kerrisk - Correct discussion of when BSD vs SysV version is used in glibc - -sin.3 - Michael Kerrisk - errno is now correctly set to EDOM on a domain error - http://sources.redhat.com/bugzilla/show_bug.cgi?id=6781 - was (silently) resolved. - -tan.3 - Michael Kerrisk - errno is now correctly set to EDOM on a domain error - http://sources.redhat.com/bugzilla/show_bug.cgi?id=6782 - was (silently) resolved. - -wcscasecmp.3 -wcsncasecmp.3 -wcsnlen.3 - Michael Kerrisk - Added VERSIONS section - -boot.7 - Yuri Kozlov - Update list of major Linux distributions - -feature_test_macros.7 - Michael Kerrisk - Make text on required placement of macros more prominent - Move the text that notes the requirement that feature test macros - must be defined before including any header files to the top of - the page, and highlight the text further, so that the reader will - not miss this point. - -ip.7 - Jiri Olsa - Document IP_NODEFRAG - This option is new in Linux 2.6.36 - -pthreads.7 -signal.7 - Michael Kerrisk - Add SEE ALSO reference to new sigevent(7) page - -tcp.7 - Michael Kerrisk - Clarify header file details for SIOCINQ and SIOCOUTQ - Also note synonymous FIONREAD and TIOCOUTQ. - -unix.7 - Michael Kerrisk - Document SIOCINQ ioctl() operation diff --git a/Changes.old b/Changes.old index aac908de8..76221adae 100644 --- a/Changes.old +++ b/Changes.old @@ -20043,3 +20043,511 @@ tzfile.5 by continuing to maintain a separate copy in man-pages.) See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=594219 + + +==================== Changes in man-pages-3.27 ==================== + +Released: 2010-09-22, Nuernberg + + +Contributors +------------ + +The following people contributed notes, ideas, or patches that have +been incorporated in changes in this release: + +caishuxian@gmail.com +Denis Barbier +Denis Silakov +der Mouse +Jan Kratochvil +Jim Belton +Jiri Olsa +KOSAKI Motohiro +Mark Hills +Matthew Flaschen +Michael Kerrisk +Ozgur Gurcan +Petr Baudis +Remi Denis-Courmont +Tanaka Akira +Tim Stoakes +W. Trevor King +Yuri Kozlov + +Apologies if I missed anyone! + + +New and rewritten pages +----------------------- + +sigevent.7 + Petr Baudis, Michael Kerrisk + New page to centralize description of sigevent structure + Several interfaces use this structure. Best to centralize the + common details in one place. Content taken from the existing + timerfd_create.2 and mq_open.3 pages, with additions by + Petr Baudis and Michael Kerrisk. + + +Newly documented interfaces in existing pages +--------------------------------------------- + + +Global changes +-------------- + +_exit.2 +brk.2 +chdir.2 +chmod.2 +chown.2 +chroot.2 +clock_nanosleep.2 +getdtablesize.2 +gethostname.2 +getpagesize.2 +getsid.2 +killpg.2 +mknod.2 +mknodat.2 +posix_fadvise.2 +pread.2 +readlink.2 +setpgid.2 +setpgid.2 +setreuid.2 +sigaltstack.2 +stat.2 +symlink.2 +sync.2 +truncate.2 +vfork.2 +wait.2 +wait4.2 +a64l.3 +abs.3 +acos.3 +acosh.3 +asin.3 +asinh.3 +atan.3 +atan2.3 +atanh.3 +atoi.3 +cbrt.3 +ceil.3 +clock_getcpuclockid.3 +copysign.3 +cos.3 +cosh.3 +dirfd.3 +div.3 +dprintf.3 +ecvt.3 +erf.3 +erfc.3 +exp.3 +exp2.3 +expm1.3 +fabs.3 +fdim.3 +fexecve.3 +ffs.3 +floor.3 +fma.3 +fmax.3 +fmemopen.3 +fmin.3 +fmod.3 +fpclassify.3 +frexp.3 +fwide.3 +gamma.3 +gcvt.3 +getcwd.3 +getdate.3 +getgrent.3 +gethostid.3 +getpass.3 +getpwent.3 +getsubopt.3 +getw.3 +hypot.3 +ilogb.3 +insque.3 +isalpha.3 +isgreater.3 +iswblank.3 +j0.3 +j0.3 +ldexp.3 +lockf.3 +log.3 +log10.3 +log1p.3 +log2.3 +logb.3 +lrint.3 +lround.3 +mbsnrtowcs.3 +mkdtemp.3 +mkstemp.3 +mktemp.3 +modf.3 +mq_receive.3 +mq_send.3 +nan.3 +nextafter.3 +posix_fallocate.3 +posix_memalign.3 +pow.3 +printf.3 +qecvt.3 +random.3 +realpath.3 +remainder.3 +remquo.3 +rint.3 +rint.3 +round.3 +scalb.3 +scalbln.3 +scanf.3 +siginterrupt.3 +signbit.3 +sigset.3 +sin.3 +sinh.3 +sqrt.3 +stpcpy.3 +stpncpy.3 +strdup.3 +strdup.3 +strnlen.3 +strsignal.3 +strtod.3 +strtol.3 +strtoul.3 +tan.3 +tanh.3 +tgamma.3 +trunc.3 +ttyslot.3 +ualarm.3 +usleep.3 +wcpcpy.3 +wcpncpy.3 +wcscasecmp.3 +wcsdup.3 +wcsncasecmp.3 +wcsnlen.3 +wcsnrtombs.3 +wprintf.3 + Michael Kerrisk + Add/fix/update feature test macro requirements in SYNOPSIS + Various changes to: + * Update feature test requirements to note changes in + recent glibc releases + * Correct errors in feature test macro requirements + * Add feature test macro requirements to pages where + the requirements were not previously stated. + +accept.2 +clone.2 +dup.2 +fallocate.2 +pipe.2 +readahead.2 +sched_setaffinity.2 +unshare.2 +CPU_SET.3 +endian.3 +euidaccess.3 +fexecve.3 +getpt.3 +getpw.3 +getumask.3 +getutmp.3 +gnu_get_libc_version.3 +makedev.3 +matherr.3 +mbsnrtowcs.3 +memfrob.3 +pthread_attr_setaffinity_np.3 +pthread_getattr_np.3 +pthread_setaffinity_np.3 +pthread_tryjoin_np.3 +tcgetsid.3 +wcscasecmp.3 +wcsncasecmp.3 +wcsnlen.3 +wcsnrtombs.3 +wcswidth.3 +rtld-audit.7 + Michael Kerrisk + SYNOPSIS: Add reference to feature_test_macros(7) + These pages specify feature test macros in the function + prototypes. Add a reference to feature_test_macros(7), + so that readers are pointed to the information that + feature test macros must be defined before including + *any* header file. + +clock_nanosleep.2 +clock_getcpuclockid.3 +getnetent_r.3 +getprotoent_r.3 +getrpcent_r.3 +getservent_r.3 +sigwait.3 + Michael Kerrisk + RETURN VALUE: Note that "positive error numbers" are listed in ERRORS + +fcntl.2 +intro.2 +open.2 +poll.2 +ftw.3 +intro.3 +matherr.3 +system.3 +tmpnam.3 +unix.7 + Michael Kerrisk + Note that feature test macros must be defined before *any* includes + Programmers often make the mistake of including a feature test + macro only after having already included some header files. + This patch adds some text at opportune places to remind + programmers to do things the right way. + +index.3 +stpcpy.3 +strcasecmp.3 +strcat.3 +strchr.3 +strcmp.3 +strcoll.3 +strcpy.3 +strdup.3 +strfry.3 +strpbrk.3 +strsep.3 +strspn.3 +strstr.3 +strtok.3 +strxfrm.3 + Michael Kerrisk + SEE ALSO: Add reference to string(3) + The idea here is to provide a route to discover other + string functions. + +armscii-8.7 +cp1251.7 +iso_8859-3.7 +iso_8859-5.7 +iso_8859-6.7 +iso_8859-8.7 +iso_8859-10.7 +iso_8859-11.7 +iso_8859-13.7 +iso_8859-14.7 +koi8-u.7 + Denis Barbier + Fix decimal values in encoding tables + Octal and hexadecimal values are right, but there are some + off-by one errors in decimal values. Correct values are + printed by this command: + + perl -pi -e 'if (s/^([0-7]+)\t([0-9]+)\t([0-9a-fA-F]+)//) + {printf "%03o\t%d\t%s", hex($3), hex($3), $3;};' man7/*.7 + + +Changes to individual pages +--------------------------- + +capget.2 + Michael Kerrisk + SYNOPSIS: Remove unneeded "undef _POSIX_SOURCE" + +fcntl.2 + Michael Kerrisk + Add feature test macro requirements for F_GETOWN and F_SETOWN + +fcntl.2 + Michael Kerrisk + Note feature test macro requirements for F_DUPFD_CLOEXEC + +getrlimit.2 + Michael Kerrisk + Document units for RLIMIT_RTTIME limit + This limit is in microseconds + + http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=596492 + +lseek.2 + Michael Kerrisk + Removed note about return type on ancient systems + +mount.2 + Michael Kerrisk + Definitions of various MS_* constants only appeared in glibc 2.12 + See http://sourceware.org/bugzilla/show_bug.cgi?id=11235 + +stat.2 + Michael Kerrisk + Update information on nanosecond timestamp fields + Update feature test macro requirements for exposing these fields. + Note that these fields are specified in POSIX.1-2008. + +timer_create.2 + Michael Kerrisk + Factor out generic material that was moved to new sigevent(7) page + +aio_fsync.3 + Michael Kerrisk + Add reference to new sigevent(7) page + +atanh.3 + Michael Kerrisk + glibc 2.10 fixed pole error bug + http://sourceware.org/bugzilla/show_bug.cgi?id=6759 + was resolved. + +cerf.3 + Michael Kerrisk + Make it clearer that this function is unimplemented + +cos.3 + Michael Kerrisk + errno is now correctly set to EDOM on a domain error + http://sources.redhat.com/bugzilla/show_bug.cgi?id=6780 + was (silently) resolved. + +expm1.3 + Michael Kerrisk + errno is now correctly set to ERANGE on a range error + http://sources.redhat.com/bugzilla/show_bug.cgi?id=6788 + was (silently) resolved. + +fmod.3 + Michael Kerrisk + errno is now correctly set to EDOM for the x==inf domain error + http://sources.redhat.com/bugzilla/show_bug.cgi?id=6784 + was (silently) resolved. + +insque.3 + Michael Kerrisk + Noted prev == NULL bug in glibc 2.4 and earlier + As noted by Remi Denis-Courmont, glibc nowadays allows + 'prev' to be NULL, as required by POSIX for initializing + a linear list. But in glibc 2.4 and earlier, 'prev' could + not be NULL. Add a BUGS section noting this. + + See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=551201 + +insque.3 + Michael Kerrisk + Added info on circular lists, and initializing circular lists + Michael Kerrisk + Added example program + +lgamma.3 + Michael Kerrisk + glibc 2.10 fixed pole error bug + http://sourceware.org/bugzilla/show_bug.cgi?id=6777 + was (silently) resolved. + +log2.3 + Matthew Flaschen + log2() function does not conform to C89 + log2(), log2f(), and log2l() do not conform to C89. + They are defined in C99. See http://flash-gordon.me.uk/ansi.c.txt + and http://www.schweikhardt.net/identifiers.html + +mq_notify.3 + Michael Kerrisk + Factor out generic material that was moved to new sigevent(7) page + +pow.3 + Michael Kerrisk + errno is now correctly set to ERANGE on a pole error + http://sources.redhat.com/bugzilla/show_bug.cgi?id=6776 + was (silently) resolved. + +pthread_kill_other_threads_np.3 + Michael Kerrisk + CONFORMING TO: Note meaning of "_np" suffix + +rand.3 + Michael Kerrisk + Clarify description of range of returned value + Michael Kerrisk + Add an example program + Michael Kerrisk + Expand description of rand_r() + +random.3 + W. Trevor King + Update initstate() return value description to match glibc + +readdir.3 + Michael Kerrisk + Clarify that "positive error numbers" are listed in ERRORS + Reported-by fkater@googlemail.com + +rexec.3 + Michael Kerrisk + SYNOPSIS: Add header file and feature test macro requirements + +sigpause.3 + Michael Kerrisk + Correct discussion of when BSD vs SysV version is used in glibc + +sin.3 + Michael Kerrisk + errno is now correctly set to EDOM on a domain error + http://sources.redhat.com/bugzilla/show_bug.cgi?id=6781 + was (silently) resolved. + +tan.3 + Michael Kerrisk + errno is now correctly set to EDOM on a domain error + http://sources.redhat.com/bugzilla/show_bug.cgi?id=6782 + was (silently) resolved. + +wcscasecmp.3 +wcsncasecmp.3 +wcsnlen.3 + Michael Kerrisk + Added VERSIONS section + +boot.7 + Yuri Kozlov + Update list of major Linux distributions + +feature_test_macros.7 + Michael Kerrisk + Make text on required placement of macros more prominent + Move the text that notes the requirement that feature test macros + must be defined before including any header files to the top of + the page, and highlight the text further, so that the reader will + not miss this point. + +ip.7 + Jiri Olsa + Document IP_NODEFRAG + This option is new in Linux 2.6.36 + +pthreads.7 +signal.7 + Michael Kerrisk + Add SEE ALSO reference to new sigevent(7) page + +tcp.7 + Michael Kerrisk + Clarify header file details for SIOCINQ and SIOCOUTQ + Also note synonymous FIONREAD and TIOCOUTQ. + +unix.7 + Michael Kerrisk + Document SIOCINQ ioctl() operation