Workaround for building apidoc

Applying the workaround to allow building apidoc in Sphinx version >1.7 (readthedocs/readthedocs.org#1139)

Author: Martin Gallo

docs/conf.py

@@ -163,5 +163,29 @@
 
 
 # Automatically build API docs
-from sphinx.apidoc import main as apidoc_main
-apidoc_main(["-f", "-e", "-M", "-o", "api/", "../pysap"])
+def run_apidoc(_):
+    ignore_paths = [
+    ]
+
+    argv = [
+        "-f",
+        "-T",
+        "-e",
+        "-M",
+        "-o", "api/",
+        "../pysap"
+    ] + ignore_paths
+
+    try:
+        # Sphinx 1.7+
+        from sphinx.ext import apidoc
+        apidoc.main(argv)
+    except ImportError:
+        # Sphinx 1.6 (and earlier)
+        from sphinx import apidoc
+        argv.insert(0, apidoc.__file__)
+        apidoc.main(argv)
+
+
+def setup(app):
+    app.connect('builder-inited', run_apidoc)