Fix Sphinx deprecation warning when building docs (spack#12205)

adamjstewart · alalazo · commit d973fca00ec8 · 2019-07-31T10:23:56.000+02:00
* Fix Sphinx deprecation warning when building docs

* Set minimum required version of Sphinx
diff --git a/lib/spack/docs/conf.py b/lib/spack/docs/conf.py
@@ -68,7 +68,6 @@
 # Without this, the API Docs will never actually update
 #
 apidoc_args = [
-    '--force',         # Older versions of Sphinx ignore the first argument
     '--force',         # Overwrite existing files
     '--no-toc',        # Don't create a table of contents file
     '--output-dir=.',  # Directory to place all output
@@ -91,12 +90,12 @@ def resolve_xref(self, env, fromdocname, builder, typ, target, node, contnode):
             env, fromdocname, builder, typ, target, node, contnode)
 
 def setup(sphinx):
-    sphinx.override_domain(PatchedPythonDomain)
+    sphinx.add_domain(PatchedPythonDomain, override=True)
 
 # -- General configuration -----------------------------------------------------
 
 # If your documentation needs a minimal Sphinx version, state it here.
-#needs_sphinx = '1.0'
+needs_sphinx = '1.8'
 
 # Add any Sphinx extension module names here, as strings. They can be extensions
 # coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
