X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=make-man-index.py;h=56f38ce413e5e7fc6057e2cd1ffa3ac324adc1fd;hp=1333521a589944a5526d4f13fc8a027ac28fb380;hb=c3cfed0d6cd9f537aa998096a43b80e98d99c6c4;hpb=9c4fa6ed1069e98db5f01a5d1056b443a04cc7d9

diff --git a/make-man-index.py b/make-man-index.py
index 1333521a5..56f38ce41 100755
--- a/make-man-index.py
+++ b/make-man-index.py
@@ -1,19 +1,49 @@
 #!/usr/bin/env python
+#  -*- Mode: python; indent-tabs-mode: nil -*- */
+#
+#  This file is part of systemd.
+#
+#  Copyright 2012 Lennart Poettering
+#
+#  systemd is free software; you can redistribute it and/or modify it
+#  under the terms of the GNU Lesser General Public License as published by
+#  the Free Software Foundation; either version 2.1 of the License, or
+#  (at your option) any later version.
+#
+#  systemd is distributed in the hope that it will be useful, but
+#  WITHOUT ANY WARRANTY; without even the implied warranty of
+#  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+#  Lesser General Public License for more details.
+#
+#  You should have received a copy of the GNU Lesser General Public License
+#  along with systemd; If not, see <http://www.gnu.org/licenses/>.
 
 from xml.etree.ElementTree import parse, Element, SubElement, tostring
-import sys
+from sys import argv, stdout
 
 index = {}
 
-for p in sys.argv[1:]:
+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;
+        section = t.find('./refmeta/manvolnum').text
+        purpose = ' '.join(t.find('./refnamediv/refpurpose').text.split())
         for f in t.findall('./refnamediv/refname'):
-                index[f.text] = (p, section)
-
-k = index.keys()
-k.sort(key = str.lower)
-
+                index[f.text] = (p, section, purpose)
 
 html = Element('html')
 
@@ -26,9 +56,8 @@ h1 = SubElement(body, 'h1')
 h1.text = 'Manual Page Index'
 
 letter = None
-
-for n in k:
-        path, section = index[n]
+for n in sorted(index.keys(), key = str.lower):
+        path, section, purpose = index[n]
 
         if path.endswith('.xml'):
                 path = path[:-4] + ".html"
@@ -40,16 +69,28 @@ for n in k:
         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 = ' -- '
+
+        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)
 
-print tostring(html)
+if hasattr(stdout, "buffer"):
+	stdout = stdout.buffer
+prettify(html)
+stdout.write(tostring(html))