Updating docs

Makefile

@@ -41,8 +41,8 @@ build: check
 # Documentation
 
 docs:
-	@$(PYDEV) sphinx-apidoc -f -o docs/ syn/ $$(find syn -name tests)
-	@$(PYDEV) make -C docs html
+	@$(PYDEV) bash -c "pip install -e .; sphinx-apidoc -f -o docs/ syn/ $$(find syn -name tests); make -C docs html"
+#	@$(PYDEV) make -C docs html
 
 view:
 	@python -c "import webbrowser as wb; \

docs/conf.py

@@ -25,7 +25,7 @@ def read(fpath):
 # If extensions (or modules to document with autodoc) are in another directory,
 # add these directories to sys.path here. If the directory is relative to the
 # documentation root, use os.path.abspath to make it absolute, like shown here.
-sys.path.insert(0, os.path.abspath('..'))
+#sys.path.insert(0, os.path.abspath('..'))
 
 # -- General configuration ------------------------------------------------
 

docs/index.rst

@@ -10,7 +10,7 @@ Contents:
 .. toctree::
    :maxdepth: 2
 
-   syn
+   syn.utils
    changelog
 
 Indices and tables

docs/syn.utils.cmdargs.rst

@@ -0,0 +1,22 @@
+syn.utils.cmdargs package
+=========================
+
+Submodules
+----------
+
+syn.utils.cmdargs.args module
+-----------------------------
+
+.. automodule:: syn.utils.cmdargs.args
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+
+Module contents
+---------------
+
+.. automodule:: syn.utils.cmdargs
+    :members:
+    :undoc-members:
+    :show-inheritance:

docs/syn.utils.rst

@@ -0,0 +1,17 @@
+syn.utils package
+=================
+
+Subpackages
+-----------
+
+.. toctree::
+
+    syn.utils.cmdargs
+
+Module contents
+---------------
+
+.. automodule:: syn.utils
+    :members:
+    :undoc-members:
+    :show-inheritance: