make sphinx work

Author: smurfix

ci/rtd-requirements.txt

@@ -1,4 +1,4 @@
 # RTD is currently installing 1.5.3, which has a bug in :lineno-match:
-sphinx >= 1.6.1
+sphinx >= 1.7.0
 sphinx_rtd_theme
 sphinxcontrib-trio

docs/source/conf.py

@@ -28,8 +28,12 @@
 nitpick_ignore = [
     # Format is ("sphinx reference type", "string"), e.g.:
     ("py:obj", "bytes-like"),
+    ("py:class", "trio_gpio.gpio.Chip"),
+    ("py:class", "trio_gpio.gpio.Line"),
 ]
 
+autodoc_inherit_docstrings = False
+
 # -- General configuration ------------------------------------------------
 
 # If your documentation needs a minimal Sphinx version, state it here.

docs/source/usage.rst

@@ -28,7 +28,7 @@ assuming there's more than one.
 The ``consumer`` argument is optional. It describes your code to the kernel, so that
 a program which enumerates GPIO users can display who currently uses the pin in question.
 
-.. autofunction:: open_chip
+.. autofunction:: trio_gpio.open_chip
 
 Referring to a line
 -------------------

trio_gpio/__init__.py

@@ -2,10 +2,10 @@
 
 import sys
 
-from ._version import __version__
+from ._version import __version__  # noqa
 
 from .gpio import Chip
-from .libgpiod import *
+from .libgpiod import *  # noqa
 
 def open_chip(num=0, consumer=sys.argv[0]):
     """Returns an object representing a GPIO chip.