Deprecating sphinxext/autosummary in favor of the version in Sphinx >= 0.7

1 files changed, 17 insertions, 8 deletions

diff --git a/doc/source/conf.py b/doc/source/conf.py
index 6261bd8bb..d5ab2cd78 100644
--- a/doc/source/conf.py
+++ b/doc/source/conf.py
@@ -2,26 +2,28 @@
 
 import sys, os, re
 
-# If your extensions are in another directory, add it here. If the directory
-# is relative to the documentation root, use os.path.abspath to make it
-# absolute, like shown here.
-sys.path.append(os.path.abspath('../sphinxext'))
-
 # Check Sphinx version
 import sphinx
 if sphinx.__version__ < "0.5":
     raise RuntimeError("Sphinx 0.5.dev or newer required")
 
-
 # -----------------------------------------------------------------------------
 # General configuration
 # -----------------------------------------------------------------------------
 
 # Add any Sphinx extension module names here, as strings. They can be extensions
 # coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
+
+sys.path.append(os.path.abspath('../sphinxext'))
+
 extensions = ['sphinx.ext.autodoc', 'sphinx.ext.pngmath', 'numpydoc',
-              'phantom_import', 'autosummary', 'sphinx.ext.intersphinx',
-              'sphinx.ext.coverage', 'only_directives']
+              'sphinx.ext.intersphinx', 'sphinx.ext.coverage',
+              'only_directives']
+
+if sphinx.__version__ >= "0.7":
+    extensions.append('sphinx.ext.autosummary')
+else:
+    extensions.append('autosummary')
 
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ['_templates']
@@ -211,6 +213,13 @@ intersphinx_mapping = {'http://docs.python.org/dev': None}
 phantom_import_file = 'dump.xml'
 
 # -----------------------------------------------------------------------------
+# Autosummary
+# -----------------------------------------------------------------------------
+
+import glob
+autosummary_generate = glob.glob("reference/*.rst")
+
+# -----------------------------------------------------------------------------
 # Coverage checker
 # -----------------------------------------------------------------------------
 coverage_ignore_modules = r"""