Replace handmade api docs with autogenerated api docs (#637)

* link to autogenerated docs in api reference, not manually curated api docs

* delete all the manually curated api doc rst files

* update gitignore and ignore tests_with_backend for api docs

* use templates for api docs

* newlines at end of template files

* year ranges

.gitignore

@@ -8,14 +8,7 @@
 
 # Docs files to ignore
 /docs/source/api/*.rst
-!docs/source/api/axis.rst
-!docs/source/api/containers.rst
-!docs/source/api/data_ranges.rst
-!docs/source/api/data_sources.rst
-!docs/source/api/mappers.rst
-!docs/source/api/plot_factories.rst
-!docs/source/api/renderers.rst
-!docs/source/api/visual_components
+!/docs/source/api/chaco.api.rst
 docs/build/
 
 # ignore the build directories

ci/edmtool.py

@@ -115,6 +115,7 @@
 
 doc_ignore = {
     "*/tests",
+    "chaco/tests_with_backend/*"
 }
 
 environment_vars = {
@@ -292,6 +293,7 @@ def docs(runtime, toolkit, environment):
 
     """
     parameters = get_parameters(runtime, toolkit, environment)
+    parameters["templates_dir"] = "docs/source/api/templates/"
     packages = " ".join(doc_dependencies)
     ignore = " ".join(doc_ignore)
     commands = [
@@ -305,13 +307,23 @@ def docs(runtime, toolkit, environment):
     execute(commands, parameters)
     click.echo("Done installing documentation tools")
 
+    api_path = os.path.join("docs", "source", "api")
+
+    # Remove any previously autogenerated API documentation.
+    doc_api_files = os.listdir(api_path)
+    permanent = ['chaco.api.rst', 'templates']
+    previously_autogenerated = \
+        [file for file in doc_api_files if file not in permanent]
+    for file in previously_autogenerated:
+        os.remove(os.path.join(api_path, file))
+
     click.echo(
         "Regenerating API docs in  '{environment}'".format(**parameters)
     )
-    api_path = os.path.join("docs", "source", "api")
     commands = [
-        "edm run -e {environment} -- sphinx-apidoc -e -M --no-toc -o "
+        "edm run -e {environment} -- python -m sphinx.ext.apidoc -e --no-toc -o "
         + api_path
+        + " -t {templates_dir}"
         + " chaco "
         + ignore
     ]

docs/source/api.rst

@@ -0,0 +1,16 @@
+:orphan:
+
+.. _api_reference:
+
+=============
+API Reference
+=============
+
+This document contains the auto-generated API reference documentation for
+Chaco.  For user documentation, please read the
+:doc:`Chaco User Manual <user_manual/index>`
+
+.. toctree::
+    :maxdepth: 3
+
+    api/chaco

docs/source/api/chaco.api.rst

@@ -0,0 +1,13 @@
+..
+   (C) Copyright 2006-2021 Enthought, Inc., Austin, TX
+   All rights reserved.
+   This software is provided without warranty under the terms of the BSD
+   license included in LICENSE.txt and may be redistributed only under
+   the conditions described in the aforementioned license. The license
+   is also available online at http://www.enthought.com/licenses/BSD.txt
+   Thanks for using Enthought open source!
+
+chaco.api module
+================
+
+.. automodule:: chaco.api