On 28 September 2010 19:04, Andreas Radke <a.ra...@arcor.de> wrote: > Upstream update. Please signoff (any arch). > > -Andy > > ==================== 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: > > caishux...@gmail.com > Denis Barbier <bou...@gmail.com> > Denis Silakov <sila...@ispras.ru> > der Mouse <mo...@rodents-montreal.org> > Jan Kratochvil <jan.kratoch...@redhat.com> > Jim Belton <jim.bel...@gmail.com> > Jiri Olsa <jo...@redhat.com> > KOSAKI Motohiro <kosaki.motoh...@jp.fujitsu.com> > Mark Hills <m...@pogo.org.uk> > Matthew Flaschen <matthew.flasc...@gatech.edu> > Michael Kerrisk <mtk.manpa...@gmail.com> > Ozgur Gurcan <ozgur.gur...@lpp.polytechnique.fr> > Petr Baudis <pa...@suse.cz> > Remi Denis-Courmont <r...@remlab.net> > Tanaka Akira <a...@fsij.org> > Tim Stoakes <t...@stoakes.net> > W. Trevor King <wk...@drexel.edu> > Yuri Kozlov <yu...@komyakino.ru> > > 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 fka...@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 >
Signoff x86_64