Move to Sphinx 1.7

Author: smurfix

ci/rtd-requirements.txt

@@ -1,4 +1,3 @@
-# don't use 1.5 or 1.7
-sphinx == 1.6.7
+sphinx >= 1.7.0
 sphinx_rtd_theme
 sphinxcontrib-trio

docs/source/conf.py

@@ -27,9 +27,13 @@
 # Except for these ones, which we expect to point to unknown targets:
 nitpick_ignore = [
     # Format is ("sphinx reference type", "string"), e.g.:
-    ("py:obj", "bytes-like"),
+    ("py:class", "CapacityLimiter-like object"),
+    ("py:class", "bytes-like"),
+    ("py:class", "None"),
 ]
 
+autodoc_inherit_docstrings = False
+
 # -- General configuration ------------------------------------------------
 
 # If your documentation needs a minimal Sphinx version, state it here.