ReadTheDocs

Author: Philippe Guglielmetti

_docs.bat

@@ -1,8 +1,6 @@
 cls -C
-cd goulib
-call sphinx-apidoc . -eo ..\docs\modules 
-cd ..
 cd docs
+call sphinx-apidoc ..\Goulib -eo modules 
 del modules\Goulib.rst
 del _build\html\index.html
 call make html

docs/conf.py

@@ -45,8 +45,8 @@ def get_version():
 # 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('modules'))
+sys.path.insert(0, os.path.abspath('..'))
 
 
 # -- General configuration -----------------------------------------------------
@@ -62,10 +62,10 @@ def get_version():
     'sphinx.ext.viewcode', 
     'sphinx.ext.inheritance_diagram', 
     'sphinx.ext.intersphinx',
+#    'sphinx.ext.napoleon',
     ]
-
-if not on_rtd:
-    extensions.append('sphinx.ext.napoleon')
+    
+napoleon_include_special_with_doc = False
 
 autosummary_generate = True
 
@@ -100,7 +100,6 @@ def autodoc_skip_member(app, what, name, obj, skip, options):
                   '__doc__', '__module__', '__dict__',  
                   )
     exclude = name in exclusions
-    if exclude: print name
     return skip or exclude
 
 def setup(app):

docs/modules/Goulib.geom3d.rst

@@ -0,0 +1,7 @@
+Goulib.geom3d module
+====================
+
+.. automodule:: Goulib.geom3d
+    :members:
+    :undoc-members:
+    :show-inheritance: