Add a shell command to the file MANIFEST that can display all man source

files and their section.

2 files changed, 22 insertions, 0 deletions

diff --git a/ChangeLog b/ChangeLog
index 804ae007..ca3f827d 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2013-01-24  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* Add a shell command to 'MANIFEST' that displays all man source
+	files and their section.
+
 2013-01-22  Bernd Warken  <groff-bernd.warken-72@web.de>
 
 	* Add email address in all files having the name.
diff --git a/MANIFEST b/MANIFEST
index 961053a9..3bf80ffa 100644
--- a/MANIFEST
+++ b/MANIFEST
@@ -145,6 +145,23 @@ The groff documentation is scattered upon several places.
 - Documentation in other formats are located in the `doc' directory,
   including the groff info file, tutorials, and manuals.
 
+Man-pages have source files ending in `.man'.  When running `make'
+they are transformed into an ending `.n'.  So it is very hard to
+decide into which section the man-page shall go.  Here is a shell
+command that finds all man-pages and writes the section number after
+each file name:
+
+find -type f |
+grep '[.]man$' |
+sort |
+xargs grep -e '^[.]TH ' |
+sed -e '
+s/^\(.\+\): *\.TH.*@MAN\(.*\)EXT@.*$/\1 \2/
+'
+
+This shell command shall only be run when your in the top directory of
+the groff source tree (this file should be there named MANIFEST).
+
 
 4) The roff parser