chiark / gitweb /
man: ship systemd-udevd as the real manpage
[elogind.git] / make-man-index.py
index e09d62a5e875dd64eb6ec0d9fe5d32895b98846e..8789d995eca021fbe1e427f4e20bcef27a729e02 100755 (executable)
@@ -5,10 +5,25 @@ from sys import argv, stdout
 
 index = {}
 
+def prettify(elem, indent = 0):
+        s = "\n" + indent * "  "
+        if len(elem):
+                if not elem.text or not elem.text.strip():
+                        elem.text = s + "  "
+                for e in elem:
+                        prettify(e, indent + 1)
+                        if not e.tail or not e.tail.strip():
+                                e.tail = s + "  "
+                if not e.tail or not e.tail.strip():
+                        e.tail = s
+        else:
+                if indent and (not elem.tail or not elem.tail.strip()):
+                        elem.tail = s
+
 for p in argv[1:]:
         t = parse(p)
         section = t.find('./refmeta/manvolnum').text
-        purpose = t.find('./refnamediv/refpurpose').text
+        purpose = ' '.join(t.find('./refnamediv/refpurpose').text.split())
         for f in t.findall('./refnamediv/refname'):
                 index[f.text] = (p, section, purpose)
 
@@ -36,17 +51,28 @@ for n in sorted(index.keys(), key = str.lower):
         if letter is None or n[0].upper() != letter:
                 letter = n[0].upper()
 
-                h2 = SubElement(body, 'h1')
+                h2 = SubElement(body, 'h2')
                 h2.text = letter
 
                 ul = SubElement(body, 'ul')
                 ul.set('style', 'list-style-type:none')
 
-        li = SubElement(ul, 'li');
+        li = SubElement(ul, 'li')
 
-        a = SubElement(li, 'a');
+        a = SubElement(li, 'a')
         a.set('href', path)
         a.text = n + '(' + section + ')'
-        a.tail = ' -- ' + purpose
+        a.tail = ' -- '
+
+        i = SubElement(li, 'i')
+        i.text = purpose
+
+hr = SubElement(body, 'hr')
+
+p = SubElement(body, 'p')
+p.text = "This index contains %s entries, referring to %i individual manual pages." % (len(index), len(argv)-1)
 
+if hasattr(stdout, "buffer"):
+       stdout = stdout.buffer
+prettify(html)
 stdout.write(tostring(html))