#!/usr/bin/env python
from xml.etree.ElementTree import parse, Element, SubElement, tostring
-import sys
+from sys import argv, stdout
index = {}
-for p in sys.argv[1:]:
+for p in argv[1:]:
t = parse(p)
- section = t.find('./refmeta/manvolnum').text;
+ section = t.find('./refmeta/manvolnum').text
+ purpose = t.find('./refnamediv/refpurpose').text
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')
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"
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)
+stdout.write(tostring(html))