Updates for 2.02 release.

2 files changed, 135 insertions, 109 deletions

diff --git a/Changes b/Changes
index 3a417e270..3e24bf511 100644
--- a/Changes
+++ b/Changes
@@ -1,6 +1,6 @@
-==================== Changes in man-pages-2.01 ====================
+==================== Changes in man-pages-2.02 ====================
 
-Released: 2004-12-20 (a quick one before Christmas)
+Released: ???
 
 Contributors
 ------------
@@ -8,37 +8,39 @@ Contributors
 The following people contributed notes, ideas, or patches that have
 been incorporated in changes in this release:
 
-Carsten Hey <c.hey@web.de>
-Johannes Berg <johannes@sipsolutions.de>
-Joshua Kwan <joshk@triplehelix.org>
-Marek Habersack <grendel@debian.org>
-Martin Schulze <joey@infodrom.org>
-Matthew Dempsky <jivera@flame.org>
-Matthew Gregan <kinetik@orcon.net.nz>
-Pedro Zorzenon Neto <pzn@terra.com.br>
-Tony Crawford <tony@klosterdorf.de>
+Andries Brouwer <Andries.Brouwer@cwi.nl>
+Branden Robinson <branden@debian.org>
+Colin Watson <cjwatson@debian.org>
+David Lloyd <dmlloyd@tds.net>
+Gordon Jin <gordon.jin@intel.com> 
+Heikki Orsila <shd@modeemi.cs.tut.fi>
+Jamie Lokier <jamie@shareable.org>
+Johan Walles
+Kai Makisara <Kai.Makisara@kolumbus.fi>
+Marko Kohtala <marko.kohtala@gmail.com>
+Martin Pool <mbp@sourcefrog.net>
+Martin (Joey) Schulze <joey@infodrom.org>
+Matthias Lang <matthias@corelatus.se>
+Michael Haardt <michael@moria.de>
+Michael Mühlebach <michael@anduin.ch>
+Mike Frysinger <vapier@gentoo.org>
+Sasa Stevanovic <mg94c18@alas.matf.bg.ac.yu>
+Serguei Leontiev <leo@sai.msu.ru>
 
 Apologies if I missed anyone!
 
 Global changes
 --------------
 
-Matthew Dempsky, mtk
-    triggered by http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=283179
-    The wording describing how errno is set was fixed up in the
-    following pages:
-
-            accept.2
-            close.2
-            send.2
-            setsid.2
-            socket.2
-            closedir.3
-            initgroups.3
-            mkstemp.3
-            opendir.3
-            readdir.3
-            telldir.3
+Martin (Joey) Schulze
+    Removed SEE ALSO reference to non-existent ctime(3) from:
+
+        ctime.3
+        tzselect.8
+        zdump.8
+        zic.8
+
+        See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=236884
 
 Typographical or grammatical errors have been corrected in several
 other places.
@@ -46,98 +48,123 @@ other places.
 Individual pages
 ----------------
 
-sendfile.2
-    mtk
-        Adjusted descriptions of argument file tyypes to be closer to 
-            2.6 reality.
-        Wording and formatting changes
-
-ctan.3
-ctanh.3
-    Tony Crawford
-        As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=270817
-        Formulae on the pages should be T = S / C not T = C / S.
-
-errno.3
-    Martin Schulze, mtk
-        Removed errno declaration from prototype, added notes
-            on historical need for this declaration.
-        http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=174175
-
-aio_return.3
-   as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=224953
-       Changed erroneous "aio_return(2)" to "aio_return(3)"
-
-posix_openpt.3
+clone.2
     mtk
-        New by mtk
+        Noted the PID caching behaviour of NPTL's getpid()
+        wrapper under BUGS.
+
+        Added futex(2), set_thread_area(2), set_tid_address(2), 
+        tkill(2) under SEE ALSO.
+
+epoll_ctl.2
+epoll_create.2
+    Marko Kohtala  / mtk
+        Improved various error descriptions.
 
-ptsname.3
+epoll_wait.2
+    David Lloyd / Mike Frysinger, Marko Kohtala
+        Added EINTR to errors.
+
+fcntl.2
+    Jamie Lokier / mtk
+        Improved discussion of F_SETOWN and F_SETSIG with respect to
+        multi-threaded programs.
+        Generally cleaned up the discussion of F_SETOWN.
+
+        Updated CONFORMING TO to note that F_GETOWN and F_SETOWN are
+        now in POSIX.
+
+link.2
+    mtk
+        Noted discrepancy between Linux and POSIX.1 when oldpath
+        is a symbolic link.
+        See: http://bugs.linuxbase.org/show_bug.cgi?id=367
+        and: http://www.opengroup.org/austin/mailarchives/ag/msg08152.html
+
+    Michael Haardt / mtk
+        Clarified EXDEV error description: it isn't possible to link
+        across mount points, even if the mount points refer to the same
+        file system.
+
+mincore.2
+    mtk, after note from Gordon Jin
+        Updated ERRORS
+
+pipe.2
+    As per message from Serguei Leontiev
+        Removed SVr2, AT&T, and BSD from CONFORMING TO, since
+        a pipe on those systems is actually bidirectional.
+        (Pipes are implemented as STREAMS on the former, and 
+        sockets on the latter.)
+
+posix_fadvise.2
     mtk
-        Added description of ptsname_r().
-        Added ERRORS.
+        Noted kernel version where posix_fadvise() appeared and
+        noted bug in handling of 'len' in kernels < 2.6.6.
 
-ptsname_r.3
+rename.2
+    Michael Haardt
+        Clarified EXDEV error description: it isn't possible to rename
+        a file across mount points, even if the mount points refer to 
+        the same file system.
+
+semop.2
     mtk
-        New link to ptsname.3
-
-shm_open.3
-    Matthew Gregan
-        add <fcntl.h> to synopsis
-        as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=271243
-
-strcasecmp.3
-    Marek Habersack <grendel@debian.org>
-            .SH "CONFORMING TO"
-            -BSD 4.4
-            +BSD 4.4, SUSv3
-        as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=234443
-        
-strfry.3
-    Joshua Kwan
-        Added _GNU_SOURCE to prototype
-        as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=213538
-                
-strftime.3
-    Cartsen Hey
-        as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=276248
+        Noted kernel version numbers for semtimedop().
+
+setitimer.2
+    Matthias Lang, mtk
+        Noted MAX_SEC_IN_JIFFIES ceiling.
+        Added note about treatment of out-of-range tv_usec values.
+
+sigqueue.2
+    Johan Walles, Martin (Joey) Schulze
+        Added sigqueue.2 to SEE ALSO
 
-        Changed range for "%S" from 0..61 to 0..60.
+times.2
+    mtk
+        Added notes on non-standard behaviour: Linux allows 'buf' to
+        be NULL, but POSIX.1 doesn't specify this and it's non-portable.
 
-        SUSv3 says 0..60.  I think the manual page probably says 
-        0..61, because that's what SUSv2 said.
-        (Some other implementations' man pages also say 0..61 -- 
-        e.g., Solaris 8 & 9, Tru64 5.1B; FreeBSD 5.1 says 0..60.)
+uselib.2
+    Andries Brouwer
+        Improved DESCRIPTION; clarified distinction between
+        EACCES and ENOEXEC.
 
-        The glibc manual currently says 0..60.
+bcopy.3
+    Heikki Orsila
+        bcopy() handles overlapping case, but memcpy does not,
+        so for consistency memmove() should be also mentioned.
 
-        Given that SUSv3 says 0..60, I've changed this the 
-        manual page to also say this:
+getmntent_r.3
+    Martin (Joey) Schulze
+        New link to man3/getmntent.3.
 
-            -The second as a decimal number (range 00 to 61).
-            +The second as a decimal number (range 00 to 60).
-            +(The range is up to 60 to allow for occasional leap seconds.)
+memcpy.3
+    Small wording change after suggestion from Sasa Stevanovic.
 
-sysconf.3
-    Johannes Berg / http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=226974
-        -.BR POSIX2_FORT_RUN " - " _SC_2_FORT_DEV
-        +.BR POSIX2_FORT_DEV " - " _SC_2_FORT_DEV
+strcasestr.3
+    mtk
+        Created as link to strstr.3.
 
-system.3
-    Pedro Zorzenon 
-        as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=242638
-        Noted use of _XOPEN_SOURCE to get macros <sytdlib.h> 
-        as for wait(2).
+strftime.3
+    mtk
+        Noted that SUSv2 allowed a range of 00 to 61 for %S specifier.
 
+strstr.3
     mtk
-        Changed name of argument from 'string' to 'command' (like POSIX).
+        Added description of strcasestr().
 
-        Noted that glibc does nowadays explicitly check for the existence
-        of the shell if 'command' is NULL, rather than the older behaviour
-        of assuming the shell exists and always returning 1 if
-        'command' is NULL.
+random.4
+    aeb
+        Improved description of read from /dev/urandom.
 
-        Other wording and formatting clean-ups.
+st.4
+    Kai Makisara
+        Substantial updates.
 
-undocumented.3
-    Remove some functions names that *are* documented.
+man.7
+    Martin Schulze <joey@infodrom.org>
+    Branden Robinson <branden@debian.org>
+    Colin Watson <cjwatson@debian.org>
+        Mention the .URL macro more verbosely.
diff --git a/Changes.old b/Changes.old
index 8be2baee1..89997d49b 100644
--- a/Changes.old
+++ b/Changes.old
@@ -417,7 +417,7 @@ ptsname.3
 
 ptsname_r.3
     mtk
-        New link to ptsname.3
+        New link to ptsname.3.
 
 shm_open.3
     Matthew Gregan
@@ -440,7 +440,7 @@ strftime.3
     Cartsen Hey
         as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=276248
 
-        Changed range for "%S" from 0..61 to 0..60.
+        Changed range for "%S" from 0..61 to 0..0.
 
         SUSv3 says 0..60.  I think the manual page probably says 
         0..61, because that's what SUSv2 said.
@@ -449,7 +449,7 @@ strftime.3
 
         The glibc manual currently says 0..60.
 
-        Given that SUSv3 says 0..60, I've changed this the 
+        Given that SUSv3 says 0..60, I've changed the 
         manual page to also say this:
 
             -The second as a decimal number (range 00 to 61).
@@ -479,4 +479,3 @@ system.3
 
 undocumented.3
     Remove some functions names that *are* documented.
-