From a78b0f182749b9e22047193987dc537927009f52 Mon Sep 17 00:00:00 2001
From: Roland McGrath <roland@gnu.org>
Date: Sun, 14 Jul 1996 17:48:00 +0000
Subject: [PATCH] * MakeTAGS (extract): Pass --add-comments=TRANS.

	* sysdeps/gnu/errlist.awk: Write comments into the output with the
	descriptive paragraphs from the manual preceded by TRANS.
---
 ChangeLog               |  4 ++++
 MakeTAGS                |  2 +-
 manual/errno.texi       |  2 ++
 sysdeps/gnu/errlist.awk | 15 +++++++++++++++
 4 files changed, 22 insertions(+), 1 deletion(-)

diff --git a/ChangeLog b/ChangeLog
index 29adb971ef..984bab71c3 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,9 @@
 Sun Jul 14 01:51:39 1996  Roland McGrath  <roland@delasyd.gnu.ai.mit.edu>
 
+	* MakeTAGS (extract): Pass --add-comments=TRANS.
+	* sysdeps/gnu/errlist.awk: Write comments into the output with the
+	descriptive paragraphs from the manual preceded by TRANS.
+
 	* elf/rtld.c (RESOLVE): Use the dl's load address, not a constant zero!
 	(_dl_start): Move RESOLVE defn inside this function and #include
 	"dynamic-link.h" a second time there.
diff --git a/MakeTAGS b/MakeTAGS
index f734cbc327..10b837c9cb 100644
--- a/MakeTAGS
+++ b/MakeTAGS
@@ -132,7 +132,7 @@ endif
 
 define extract
 @rm -f $@.new
-$(XGETTEXT) --keyword=_ --keyword=N_ --sort-output -d - \
+$(XGETTEXT) --keyword=_ --keyword=N_ --add-comments=TRANS --sort-output -d - \
 	    $(XGETTEXTFLAGS-$(@F)) > $@.new $^
 mv -f $@.new $@
 endef
diff --git a/manual/errno.texi b/manual/errno.texi
index 09c6ac68cf..8f752b39ec 100644
--- a/manual/errno.texi
+++ b/manual/errno.texi
@@ -869,6 +869,8 @@ up, before it has connected to the file.
 @deftypevr Macro int ED
 @comment errno 102 @c DO NOT REMOVE
 The experienced user will know what is wrong.
+@c This error code is a joke.  Its perror text is part of the joke.
+@c Don't change it.
 @end deftypevr
 
 @comment errno.h
diff --git a/sysdeps/gnu/errlist.awk b/sysdeps/gnu/errlist.awk
index e6ca81a4ad..c68e70df9a 100644
--- a/sysdeps/gnu/errlist.awk
+++ b/sysdeps/gnu/errlist.awk
@@ -21,6 +21,8 @@
 # @comment POSIX.1: Function not implemented
 # @deftypevr Macro int ENOSYS
 # @comment errno 78
+# Descriptive paragraph...
+# @end deftypevr
 
 BEGIN {
     alias["EWOULDBLOCK"] = "EAGAIN";
@@ -54,10 +56,23 @@ errnoh == 3 && $1 == "@comment" && $2 == "errno" \
       printf "#if defined (%s) && %s != %s\n", e, e, alias[e];
     else
       printf "#ifdef %s\n", e;
+    errnoh = 4;
+    desc="";
+    next;
+  }
+errnoh == 4 && $1 == "@end" && $2 == "deftypevr" \
+  {
+    printf "/*%s */\n", desc;
     printf "    [%s] = N_(\"%s\"),\n", e, etext;
     print "#endif";
+    errnoh = 0;
     next;
   }
+errnoh == 4 \
+  {
+    # This magic tag in C comments gets them copied into libc.pot.
+    desc = desc "\nTRANS " $0; next
+  }
 { errnoh=0 }
 END {
   print "  };";