diff --git a/doc/source/conf.py b/doc/source/conf.py
index fdb2c569463b2f3036a4ca2e3f5faeef80c44c5c..69a4ca247c9feed73bb9e6f9b45cda93153f127e 100644
--- a/doc/source/conf.py
+++ b/doc/source/conf.py
@@ -20,6 +20,10 @@ import os
import sys
sys.path.insert(0, os.path.abspath('.'))
sys.path.insert(0, os.path.abspath('../../gstlal/python'))
+sys.path.insert(0, os.path.abspath('../../gstlal-inspiral/python'))
+#sys.path.insert(0, os.path.abspath('../../gstlal-burst/python'))
+sys.path.insert(0, os.path.abspath('../../gstlal-calibration/python'))
+sys.path.insert(0, os.path.abspath('../../gstlal-ugly/python'))
# -- General configuration ------------------------------------------------
diff --git a/doc/source/gstlal-burst/code.rst b/doc/source/gstlal-burst/code.rst
index deebd9f8051a63372b94e33c6cd5b23fb2192029..cd6e78a90f22810d684132949bd66b1c9bf8b71b 100644
--- a/doc/source/gstlal-burst/code.rst
+++ b/doc/source/gstlal-burst/code.rst
@@ -1,8 +1,11 @@
-GstLAL Code
-===========
+GstLAL burst code
+=================
.. toctree::
:maxdepth: 2
+.. This code should be uncommented once the burst package is in good shape
+
+..
bin/bin
python-modules/modules
diff --git a/doc/source/gstlal-burst/gstlal-burst.rst b/doc/source/gstlal-burst/gstlal-burst.rst
index 461fd908be46f15f85f7c80ce8049dd24f257e8a..a46a0af4a3ddc6bfeeb81296acc4a8619e2a8536 100644
--- a/doc/source/gstlal-burst/gstlal-burst.rst
+++ b/doc/source/gstlal-burst/gstlal-burst.rst
@@ -1,5 +1,5 @@
-GstLAL project
-==============
+GstLAL burst project
+====================
.. toctree::
:maxdepth: 2
diff --git a/doc/source/gstlal-calibration/code.rst b/doc/source/gstlal-calibration/code.rst
index deebd9f8051a63372b94e33c6cd5b23fb2192029..32af0844633756524a9a65daf4813637676a0833 100644
--- a/doc/source/gstlal-calibration/code.rst
+++ b/doc/source/gstlal-calibration/code.rst
@@ -1,5 +1,5 @@
-GstLAL Code
-===========
+GstLAL calibration code
+=======================
.. toctree::
:maxdepth: 2
diff --git a/doc/source/gstlal-calibration/gstlal-calibration.rst b/doc/source/gstlal-calibration/gstlal-calibration.rst
index 461fd908be46f15f85f7c80ce8049dd24f257e8a..5946e59bc7e0bb1c4565564e07c9071440247a27 100644
--- a/doc/source/gstlal-calibration/gstlal-calibration.rst
+++ b/doc/source/gstlal-calibration/gstlal-calibration.rst
@@ -1,5 +1,5 @@
-GstLAL project
-==============
+GstLAL calibration project
+==========================
.. toctree::
:maxdepth: 2
diff --git a/doc/source/gstlal-inspiral/code.rst b/doc/source/gstlal-inspiral/code.rst
index deebd9f8051a63372b94e33c6cd5b23fb2192029..5796dbaece2ebe08c1bf598fd68c1977c19ad2c1 100644
--- a/doc/source/gstlal-inspiral/code.rst
+++ b/doc/source/gstlal-inspiral/code.rst
@@ -1,5 +1,5 @@
-GstLAL Code
-===========
+GstLAL inspiral code
+====================
.. toctree::
:maxdepth: 2
diff --git a/doc/source/gstlal-inspiral/gstlal-inspiral.rst b/doc/source/gstlal-inspiral/gstlal-inspiral.rst
index 461fd908be46f15f85f7c80ce8049dd24f257e8a..ac4c6a886ae1145d95ab222d327ee1899c225a2d 100644
--- a/doc/source/gstlal-inspiral/gstlal-inspiral.rst
+++ b/doc/source/gstlal-inspiral/gstlal-inspiral.rst
@@ -1,5 +1,5 @@
-GstLAL project
-==============
+GstLAL inspiral project
+=======================
.. toctree::
:maxdepth: 2
diff --git a/doc/source/gstlal-ugly/code.rst b/doc/source/gstlal-ugly/code.rst
index deebd9f8051a63372b94e33c6cd5b23fb2192029..3aba8eab0457aa656db820bea529b85101018074 100644
--- a/doc/source/gstlal-ugly/code.rst
+++ b/doc/source/gstlal-ugly/code.rst
@@ -1,5 +1,5 @@
-GstLAL Code
-===========
+GstLAL ugly code
+================
.. toctree::
:maxdepth: 2
diff --git a/doc/source/gstlal-ugly/gstlal-ugly.rst b/doc/source/gstlal-ugly/gstlal-ugly.rst
index 461fd908be46f15f85f7c80ce8049dd24f257e8a..992f02f7e897a6796e7f1a3d0ea21d515d3ddecf 100644
--- a/doc/source/gstlal-ugly/gstlal-ugly.rst
+++ b/doc/source/gstlal-ugly/gstlal-ugly.rst
@@ -1,5 +1,5 @@
-GstLAL project
-==============
+GstLAL ugly project
+===================
.. toctree::
:maxdepth: 2
diff --git a/doc/source/gstlal/gstlal.rst b/doc/source/gstlal/gstlal.rst
index 461fd908be46f15f85f7c80ce8049dd24f257e8a..21e932c4de289d47dc1c34e695948448758fdd0e 100644
--- a/doc/source/gstlal/gstlal.rst
+++ b/doc/source/gstlal/gstlal.rst
@@ -5,4 +5,6 @@ GstLAL project
:maxdepth: 2
overview
+ tutorials/tutorials
code
+
diff --git a/doc/source/index.rst b/doc/source/index.rst
index 657a12564a29c56e8bd9d2c425a990332aa5b9fc..47d58c6fd0bbd78ffac9d3aaa000799100ed4f1b 100644
--- a/doc/source/index.rst
+++ b/doc/source/index.rst
@@ -15,9 +15,6 @@ The GstLAL project documentation
projects
-Indices and tables
-==================
-
-* :ref:`genindex`
-* :ref:`modindex`
-* :ref:`search`
++-----------------+-----------------+---------------+
+| :ref:`genindex` | :ref:`modindex` | :ref:`search` |
++-----------------+-----------------+---------------+
diff --git a/doc/sphinx-bindoc b/doc/sphinx-bindoc
index 34faed076a10304a0b63afc0d602d4f5a47c6a22..8d537747c2f633b0e5d66b96cb1936fef17e4bf0 100755
--- a/doc/sphinx-bindoc
+++ b/doc/sphinx-bindoc
@@ -13,10 +13,10 @@ def process_source(prog, outfile):
if len(sys.argv) == 1:
- print "USAGE: sphinx-bindoc <output directory> <input directory>"
+ print "USAGE: sphinx-bindoc <output directory> <input directory> [patterns to exclude]"
sys.exit()
-assert(len(sys.argv) == 3)
+assert(len(sys.argv) >= 3)
indir = sys.argv[2]
outdir = sys.argv[1]
@@ -29,16 +29,26 @@ tocf.write("""bin
:maxdepth: 1
""")
-for prog in os.listdir(indir):
+for prog in sorted(os.listdir(indir)):
# Don't document make files
if "Makefile" in prog:
continue
+ if prog in sys.argv[3:]:
+ continue
path_to_prog = os.path.join(indir, prog)
# Write the rst file that contains command line arguments
fname = os.path.join(outdir, prog+".rst")
- print >> sys.stderr, "Creating file ", fname
+
+ # register this program in the master list of programs
+ tocf.write("\n %s" % os.path.split(fname)[-1].replace(".rst",""))
+
+ if os.path.exists(fname):
+ print >> sys.stderr, "File %s already exists, skipping." % fname
+ continue
+ else:
+ print >> sys.stderr, "Creating file ", fname
f = open(fname, "w", 0)
# parse the bin program itself for additional documentation
@@ -47,12 +57,13 @@ for prog in os.listdir(indir):
# write the output of --help
f.write("%s\n%s\n\n" % ("Command line options", "".join(["-"] * len("Command line options"))))
- subprocess.call([path_to_prog, "--help"], stdout = f)
+ f.write("\n\n.. code-block:: none\n\n")
+ proc = subprocess.Popen([path_to_prog, "--help"], stdout = subprocess.PIPE)
+ helpmessage = proc.communicate()[0]
+ helpmessage = "\n".join([" %s" % l for l in helpmessage.split("\n")])
+ f.write(helpmessage)
# close the file
f.close()
- # register this program in the master list of programs
- tocf.write("\n %s" % os.path.split(fname)[-1].replace(".rst",""))
-
tocf.close()