Ready for 2.21man-pages-2.21

3 files changed, 76 insertions, 61 deletions

diff --git a/Changes b/Changes
index 520a5b555..3074c4496 100644
--- a/Changes
+++ b/Changes
@@ -1,6 +1,6 @@
 ==================== Changes in man-pages-2.21 ====================
 
-Released: 2006-??-??
+Released: 2006-01-16
 
 Contributors
 ------------
@@ -9,7 +9,9 @@ The following people contributed notes, ideas, or patches that have
 been incorporated in changes in this release:
 
 Andries Brouwer <Andries.Brouwer@cwi.nl>
+Falk Hueffner <falk@debian.org>
 Mike Frysinger <vapier@gentoo.org>
+Senthil Kumar <senthilkumar_sen@hotpop.com>
 Stefan Puiu <stefanpuiuro@yahoo.com>
 
 Apologies if I missed anyone!
@@ -18,65 +20,31 @@ Apologies if I missed anyone!
 Global changes
 --------------
 
-dd.1
-cp.1
-truncate.2
-gethostname.2
-lseek.2
-listxattr.2
-readlink.2
-sysfs.2
-stat.2
-ustat.2
-uname.2
-getdomainname.2
-getlogin.3
-ttyname.3
-getpass.3
-getline.3
-hsearch.3
-bzero.3
-string.3
-scanf.3
-getnameinfo.3
-dlopen.3
-stpcpy.3
-sysconf.3
-readdir.3
-argz_add.3
-perror.3
-gethostbyname.3
-confstr.3
-bstring.3
-strdup.3
-printf.3
-strptime.3
-termios.3
-strftime.3
-fwide.3
-strfmon.3
-asprintf.3
-tty_ioctl.4
-dsp56k.4
-elf.5
-termcap.5
-proc.5
-charsets.7
-unix.7
+dd.1 cp.1 
+truncate.2 gethostname.2 lseek.2 listxattr.2 readlink.2
+sysfs.2 stat.2 ustat.2 uname.2 getdomainname.2
+argz_add.3 asprintf.3 confstr.3 bstring.3 bzero.3 dlopen.3 fwide.3
+gethostbyname.3 getline.3 getlogin.3 getnameinfo.3 getpass.3 hsearch.3 
+perror.3 printf.3 readdir.3 scanf.3 stpcpy.3 strdup.3 strfmon.3 
+strftime.3 string.3 strptime.3 sysconf.3 termios.3 ttyname.3
+dsp56k.4 tty_ioctl.4
+elf.5 proc.5 termcap.5
+charsets.7 unix.7
     mtk
         Various pages use inconsistent terms for 'null byte' (which
         is the C99/SUSv3 term for the '\0' character).
 
-        To rectify this the following changes were made in the above pages:
+        To rectify this the following changes were made in the above 
+        pages:
     
             Replace 'zero byte' with 'null byte'.
             Replace 'null character' with 'null byte'.
             Replace 'nulls' with 'null bytes'.
-      	    Replace 'NUL-terminated' by 'null-terminated'.
-	    Replace 'NUL' by 'null byte'.
-	    Replace 'terminating NUL' by 'terminating null byte'.
-	    Replace 'final NUL' by 'terminating null byte'.
-	    Replace 'NUL character' by 'null byte'.
+            Replace 'NUL-terminated' by 'null-terminated'.
+            Replace 'NUL' by 'null byte'.
+            Replace 'terminating NUL' by 'terminating null byte'.
+            Replace 'final NUL' by 'terminating null byte'.
+            Replace 'NUL character' by 'null byte'.
 
 Various pages
     mtk
@@ -86,41 +54,87 @@ Typographical or grammatical errors have been corrected in several
 places.
 
 
+New pages
+---------
+
+mmap64.3
+    Mike Frysinger
+        New link to mmap.2
+
+
 Changes to individual pages
 ---------------------------
 
+capget.2
+    mtk
+        Noted bug that could wrongly cause EPERM in unprivileged
+        capset() with 'pid' field == getpid().
+        
 epoll_ctl.2
     mtk
         Noted that EPOLLONESHOT was added in 2.6.2.
-	
+        
 gethostname.2
     mtk
         Added GLIBC NOTES describing operation of glibc's
-	gethostname() wrapper function.
+        gethostname() wrapper function.
+
+mmap.2
+    mtk / Mike Frysinger
+        Clarify relationship between mmap2(2) and mmap64(3)
+    mtk
+        A few other small rewordings.
+
+open.2
+    mtk
+        Added BUG noting that O_ASYNC can't be enabled via
+        open(): fcntl() must be used for this purpose.
 
 recv.2
     Stefan Puiu
         Relocate misplaced discussion of MSG_DONTWAIT.
     
+dlopen.3
+    mtk
+        Rewrote discussion of dlopen() 'flag' argument;
+        added description is of RTLD_NOLOAD, RTLD_DELETE, 
+        and RTLD_DEEPBIND.
+
+        Noted use of atexit() to register a function that is 
+        automatically called when a library is unloaded.
+
 fmemopen.3
     mtk
         Rewrote substantial parts of the page, and relicensed under GPL.
 
+fseeko.3
+    Mike Frysinger
+        Add RETURN VALUE section.
+
 getopt.3
     mtk
         Noted historical use of <stdio.h> to declare getopt().
 
+qsort.3
+    mtk / Falk Hueffner
+        Clarify how strcmp() should be used as the 'compar'
+        function by providing an example.
+        As per Debian bug 348072.
+
 proc.5
     mtk
         Noted that /proc/mounts is pollable since kernel 2.6.15.
 
-	Documented /proc/PID/task.
+        Documented /proc/PID/task.
 
-	Noted that the contents of /proc/PID/{cwd,exe,fd,root,task} 
-	are not available if the main thread has terminated.
+        Noted that the contents of /proc/PID/{cwd,exe,fd,root,task} 
+        are not available if the main thread has terminated.
+        
+    Senthil Kumar 
+        Add pointer to random(4) for description of files under
+        /proc/sys/kernel/random.
 
 udp.7
     Stefan Puiu / mtk
         Small rewording of discussion of SO_BSDCOMPAT 
-	(add cross-ref to socket(7)).
-    
+        (add cross-ref to socket(7)).
diff --git a/HOWTOHELP b/HOWTOHELP
index d9a204e7a..a4a6293bf 100644
--- a/HOWTOHELP
+++ b/HOWTOHELP
@@ -289,6 +289,7 @@ Library Functions
 (See a further list of missing pages in the "undocumented(3)" manual page.)
 
 adjtime(3)  
+dlinfo(3)   (Solaris and FreeBSD have a similar function.)
 dladdr1(3)
 dlmopen(3) (Since glibc 2.3.4; probably to be documented on dlopen.3 page)
 readdir_r(3) (probably as additional text in readdir.3)
diff --git a/man-pages-2.21.lsm b/man-pages-2.21.lsm
index 8f9277162..4eafa37e0 100644
--- a/man-pages-2.21.lsm
+++ b/man-pages-2.21.lsm
@@ -1,13 +1,13 @@
 Begin3
 Title:          Section 2, 3, 4, 5 and 7 man pages for Linux
 Version:        2.21
-Entered-date:   2005-??-??
+Entered-date:   2005-01-16
 Description:    Linux and POSIX manual pages
 Keywords:       man pages
 Author:         several
 Maintained-by:  Michael Kerrisk <mtk-manpages@gmx.net>
 Primary-site:   ftp://ftp.win.tue.nl/pub/linux-local/manpages
-                ????k man-pages-2.21.tar.gz
+                2521k man-pages-2.21.tar.gz
 Alternate-site: ftp://ftp.XX.kernel.org/pub/linux/docs/manpages
 Copying-policy: several; for the POSIX pages, see the file POSIX-COPYRIGHT;
 		the other pages are all freely distributable provided