Many markup fixes in doc/

Also added subdir option to generate-libbe-txt.make_module_txt(), in
the hopes that subdir='.' would fix the missing reference errors, but
no luck (although it did reduce them).  I'm sticking with
subdir='libbe' for now to avoid cluttering doc/ with autogenerated
cruft.

1 files changed, 4 insertions, 4 deletions

diff --git a/doc/generate-libbe-txt.py b/doc/generate-libbe-txt.py
index 35eb5c4..77f775a 100644
--- a/doc/generate-libbe-txt.py
+++ b/doc/generate-libbe-txt.py
@@ -34,10 +34,10 @@ def toctree(children):
             '   %s.txt' % c for c in sorted(children)
             ] + ['', ''])
 
-def make_module_txt(modname, children):
-    filename = os.path.join('libbe', '%s.txt' % modname)
-    if not os.path.exists('libbe'):
-        os.mkdir('libbe')
+def make_module_txt(modname, children, subdir='libbe'):
+    filename = os.path.join(subdir, '%s.txt' % modname)
+    if not os.path.exists(subdir):
+        os.mkdir(subdir)
     if os.path.exists(filename):
         return None # don't overwrite potentially hand-written files.
     f = file(filename, 'w')