Start of man-pages-3.28: updating Changes and Changes.old

1 files changed, 508 insertions, 0 deletions

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 <bouzim@gmail.com>
+Denis Silakov <silakov@ispras.ru>
+der Mouse <mouse@rodents-montreal.org>
+Jan Kratochvil  <jan.kratochvil@redhat.com>
+Jim Belton <jim.belton@gmail.com>
+Jiri Olsa <jolsa@redhat.com>
+KOSAKI Motohiro <kosaki.motohiro@jp.fujitsu.com>
+Mark Hills <mark@pogo.org.uk>
+Matthew Flaschen <matthew.flaschen@gatech.edu>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Ozgur Gurcan <ozgur.gurcan@lpp.polytechnique.fr>
+Petr Baudis <pasky@suse.cz>
+Remi Denis-Courmont <remi@remlab.net>
+Tanaka Akira <akr@fsij.org>
+Tim Stoakes <tim@stoakes.net>
+W. Trevor King <wking@drexel.edu>
+Yuri Kozlov <yuray@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@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