Dont depend on my vim, depend on a perl script :)

docs/Makefile

@@ -1,11 +1,9 @@
-# Dummy script to generate documentation, probably only works on my system
-# for now.  - mbp / 2002
-
 all:
-	jade -i html -t sgml -V nochunks -d /usr/share/sgml/docbook/utils-0.6.9/docbook-utils.dsl\#html pisg-doc.sgml | w3m -dump -T text/html > pisg-doc.txt
-	vim -c 'echo AddSpacers()' -c ':wq' pisg-doc.txt
+	jade -i html -t sgml -V nochunks -d /usr/share/sgml/docbook/utils-0.6.9/docbook-utils.dsl\#html pisg-doc.sgml | w3m -dump -T text/html > pisg-tmp.txt
+	cat pisg-tmp.txt | ./modifytxt.pl > pisg-doc.txt
 	docbook2html pisg-doc.sgml -o html
 
 clean:
 	rm -rf html
 	rm -f pisg-doc.txt
+	rm -f pisg-tmp.txt

docs/modifytxt.pl

@@ -0,0 +1,24 @@
+#!/usr/bin/perl -w
+
+# This is a small script which modifies the outputted txt docs into a more
+# readable one, by adding some lines to the output.
+
+use strict;
+
+my $cacheword;
+while (<>) {
+    if ($_ =~ /^(\w+)$/ && $_ !~ /^Name$/) {
+        $cacheword = $1;
+    }
+    if ($_ =~ /^Name$/) {
+        print "-----------------------\n$cacheword option\n-----------------------\n";
+    } elsif ($_ =~ /^Description$/) {
+        print "Description\n-----------\n";
+    } elsif ($_ =~ /^Synopsis$/) {
+        print "Synopsis\n--------\n";
+    } else {
+        print $_;
+    }
+
+}
+