[arch-dev-public] [signoff] man-pages 3.27-1
Guillaume ALAUX
guillaume at alaux.net
Wed Sep 29 03:09:08 EDT 2010
On 28 September 2010 19:04, Andreas Radke <a.radke at 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:
>
> caishuxian at gmail.com
> Denis Barbier <bouzim at gmail.com>
> Denis Silakov <silakov at ispras.ru>
> der Mouse <mouse at rodents-montreal.org>
> Jan Kratochvil <jan.kratochvil at redhat.com>
> Jim Belton <jim.belton at gmail.com>
> Jiri Olsa <jolsa at redhat.com>
> KOSAKI Motohiro <kosaki.motohiro at jp.fujitsu.com>
> Mark Hills <mark at pogo.org.uk>
> Matthew Flaschen <matthew.flaschen at gatech.edu>
> Michael Kerrisk <mtk.manpages at gmail.com>
> Ozgur Gurcan <ozgur.gurcan at lpp.polytechnique.fr>
> Petr Baudis <pasky at suse.cz>
> Remi Denis-Courmont <remi at remlab.net>
> Tanaka Akira <akr at fsij.org>
> Tim Stoakes <tim at stoakes.net>
> W. Trevor King <wking at drexel.edu>
> Yuri Kozlov <yuray at 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 fkater at 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
More information about the arch-dev-public
mailing list