From e92296d77d5ca430b796823ef7a3c2faa3e2586c Mon Sep 17 00:00:00 2001
From: Michael Kerrisk <mtk.manpages@gmail.com>
Date: Tue, 5 Jun 2007 20:08:28 +0000
Subject: sync

---
 Changes     | 16 ++++++++--------
 MAINTAINING | 24 ++++++++++++++++++++++--
 2 files changed, 30 insertions(+), 10 deletions(-)

diff --git a/Changes b/Changes
index 03c5dc75..063138b0 100644
--- a/Changes
+++ b/Changes
@@ -14,15 +14,15 @@ Changes to individual pages
 
 getxattr.2
     mtk
-        In kernel since 2.4; glibc support since 2.3.
+        VERSIONS: In kernel since 2.4; glibc support since 2.3.
 
 listxattr.2
     mtk
-        In kernel since 2.4; glibc support since 2.3.
+        VERSIONS: In kernel since 2.4; glibc support since 2.3.
 
 posix_fadvise.2
     mtk
-        Glibc support has been provided since version 2.2.
+        VERSIONS: Glibc support has been provided since version 2.2.
 
 readahead.2
     mtk
@@ -34,7 +34,7 @@ remap_file_pages
 
 removexattr.2
     mtk
-        In kernel since 2.4; glibc support since 2.3.
+        VERSIONS: In kernel since 2.4; glibc support since 2.3.
 
 semop.2
     mtk
@@ -42,11 +42,11 @@ semop.2
 
 setxattr.2
     mtk
-        In kernel since 2.4; glibc support since 2.3.
+        VERSIONS: In kernel since 2.4; glibc support since 2.3.
 
 dl_iterate_phdr.3
     mtk
-        Supported since glibc 2.2.4.
+        VERSIONS: Supported since glibc 2.2.4.
 
 getloadavg.3
     mtk
@@ -54,8 +54,8 @@ getloadavg.3
 
 posix_openpt.3
     mtk
-        Supported since glibc 2.2.1.
+        VERSIONS: Supported since glibc 2.2.1.
 
 shm_unlink.3
    mtk
-       Added VERSIONS section; rewote info about linking with -lrt.
+        Added VERSIONS section; rewrote info about linking with -lrt.
diff --git a/MAINTAINING b/MAINTAINING
index e4c94238..58f8ead0 100644
--- a/MAINTAINING
+++ b/MAINTAINING
@@ -37,7 +37,7 @@ Glibc source code
 
 Same story as the kernel.  
 
--- Keep up to date trees for all 2.x, x >= 0 releases.
+-- Keep up-to-date trees for all 2.x, x >= 0 releases.
 
 -- Keep diff files for all minor releases of the glibc tree.
    As with kernel, these can be grepped to help determine
@@ -102,6 +102,24 @@ Glibc releases
 
 Just as for the kernel, when a new glibc release comes out.
 
+The following is useful to get a rough idea of what symbols 
+were new or changed in various glibc releases -- execute it 
+at the root of a glibc tree:
+
+
+cat  $(find . -name 'Versions' | 
+	egrep -v '/(s390|alpha|sparc|hurd|sh4|bsd|ia64|powerpc|x86_64)') |
+    sed -n '/GLIBC/,/}/p' | sed 's/#.*//'| tr ';' '\012' |
+    sed 's/^ *//' | sed 's/ *$//' | sed '/^$/d' |
+    grep -v '^_' |
+    awk '{ if ($1 ~ "^GLIBC_2.*") {
+	         tag = $1 
+             } else if ($1 ~ "^[a-z].*") { 
+	         printf "$%-32s %s\n", $1, tag
+	     }
+         }' |
+    sort -u 
+
 Distribution bug tracking systems
 ---------------------------------
 
@@ -117,8 +135,10 @@ command; see http://www.debian.org/Bugs/server-control).
 
 Red Hat provides a man-pages bugzilla component:
 https://bugzilla.redhat.com/bugzilla/buglist.cgi?component=man-pages&&order=bugs.bug_id
+and it is possible to get subscribed to bug reports -- ask the Red Hat
+downstream maintainers.
 
-Perhaps some other distributions do the same, but these are the 
+Perhaps some other distributions have similar facilities, but these are the
 only one I know about so far.
 
 
-- 
cgit v1.2.3