min: generate an index page for all man pages

This makes use of python, if it is available

diff --git a/Makefile.am b/Makefile.am
index c9ea8047ad6673e4aab92b5ff404ae418ed1a713..a48e05bd8750c0ada0feed7f8594b40a6872fca3 100644 (file)
--- a/Makefile.am
+++ b/Makefile.am
@@ -658,14 +658,28 @@ noinst_DATA = \
 
 CLEANFILES += \
        $(MANPAGES) \
 
 CLEANFILES += \
        $(MANPAGES) \

-       $(MANPAGES_ALIAS)
+       $(MANPAGES_ALIAS) \
+       ${XML_FILES:.xml=.html}
+
+if HAVE_PYTHON
+noinst_DATA += \
+       man/index.html
+
+CLEANFILES += \
+       man/index.html
+
+man/index.html: $(XML_FILES)
+       $(AM_V_GEN)$(PYTHON) $(top_srcdir)/make-man-index.py $(XML_FILES) > $@
+endif
+

 endif
 
 EXTRA_DIST += \
        $(XML_FILES) \
        ${XML_FILES:.xml=.html} \
        $(MANPAGES) \
 endif
 
 EXTRA_DIST += \
        $(XML_FILES) \
        ${XML_FILES:.xml=.html} \
        $(MANPAGES) \

-       $(MANPAGES_ALIAS)
+       $(MANPAGES_ALIAS) \
+       make-man-index.py

 
 # ------------------------------------------------------------------------------
 noinst_LTLIBRARIES += \
 
 # ------------------------------------------------------------------------------
 noinst_LTLIBRARIES += \

diff --git a/configure.ac b/configure.ac
index c5fbec5738436d481a2a040829913caf412ad653..03644a6d60af8335e4b7a319394aac1f453c2e36 100644 (file)
--- a/configure.ac
+++ b/configure.ac
@@ -79,6 +79,10 @@ if test -z "$GPERF" ; then
         AC_MSG_ERROR([*** gperf not found])
 fi
 
         AC_MSG_ERROR([*** gperf not found])
 fi
 

+# we use python only to build the man page index
+AM_PATH_PYTHON(,, [:])
+AM_CONDITIONAL([HAVE_PYTHON], [test "$PYTHON" != :])
+

 CC_CHECK_FLAGS_APPEND([with_cflags], [CFLAGS], [\
         -pipe \
         -Wall \
 CC_CHECK_FLAGS_APPEND([with_cflags], [CFLAGS], [\
         -pipe \
         -Wall \

diff --git a/make-man-index.py b/make-man-index.py
new file mode 100755 (executable)
index 0000000..1333521
--- /dev/null
+++ b/make-man-index.py
@@ -0,0 +1,55 @@
+#!/usr/bin/env python
+
+from xml.etree.ElementTree import parse, Element, SubElement, tostring
+import sys
+
+index = {}
+
+for p in sys.argv[1:]:
+        t = parse(p)
+        section = t.find('./refmeta/manvolnum').text;
+        for f in t.findall('./refnamediv/refname'):
+                index[f.text] = (p, section)
+
+k = index.keys()
+k.sort(key = str.lower)
+
+
+html = Element('html')
+
+head = SubElement(html, 'head')
+title = SubElement(head, 'title')
+title.text = 'Manual Page Index'
+
+body = SubElement(html, 'body')
+h1 = SubElement(body, 'h1')
+h1.text = 'Manual Page Index'
+
+letter = None
+
+for n in k:
+        path, section = index[n]
+
+        if path.endswith('.xml'):
+                path = path[:-4] + ".html"
+
+        c = path.rfind('/')
+        if c >= 0:
+                path = path[c+1:]
+
+        if letter is None or n[0].upper() != letter:
+                letter = n[0].upper()
+
+                h2 = SubElement(body, 'h1')
+                h2.text = letter
+
+                ul = SubElement(body, 'ul')
+                ul.set('style', 'list-style-type:none')
+
+        li = SubElement(ul, 'li');
+
+        a = SubElement(li, 'a');
+        a.set('href', path)
+        a.text = n + '(' + section + ')'
+
+print tostring(html)