DOC: Cannot use automodapi

pllim · pllim · commit dc52e530f52a · 2021-02-22T18:12:11.000-05:00
because we need to inherit docstring.

DOC: Do not display inherited members because too confusing.
diff --git a/astrowidgets/ginga.py b/astrowidgets/ginga.py
@@ -1,4 +1,5 @@
-"""Module containing ``astrowidgets`` implemented with Ginga backend.
+"""The ``astrowidgets.ginga`` module contains a widget implemented with the
+Ginga backend.
 
 For this to work, ``astrowidgets`` must be installed along with the optional
 dependencies specified for the Ginga backend; e.g.,::
diff --git a/docs/conf.py b/docs/conf.py
@@ -45,6 +45,8 @@
 
 # -- General configuration ----------------------------------------------------
 
+autodoc_inherit_docstrings = True
+
 # By default, highlight as Python 3.
 highlight_language = 'python3'
 
diff --git a/docs/ginga.rst b/docs/ginga.rst
@@ -90,5 +90,9 @@ For more details, see `this discussion of opencv and astrowidgets
 API
 ---
 
-.. automodapi:: astrowidgets.ginga
-    :inherited-members:
+.. automodule:: astrowidgets.ginga
+
+.. inheritance-diagram:: astrowidgets.ginga.ImageWidget
+
+.. autoclass:: astrowidgets.ginga.ImageWidget
+    :members:
