This directory includes an example of Sphinx processing of Python 3
code. It required installation of the "python3-sphinx" (apt) or
"sphinx-quickstart-plus" (pip3) package. Note that the annotations are
ignored.

Starting from scratch in this directory:

1. Run the "start_over" script.

2. Run "sphinx-quickstart" and answer the questions (defaults are
   probably okay).

3. Add the modules you want to document to "index.rst" by adding

       .. automodule:: <module name>
          :members:

   under the "toctree::" entry

4. Modify "conf.py" as follows:

   * Include "." in sys.path. This requires uncommenting 3 lines,
     which are indicated.

   * Include the "autodoc" extension by changing the line::

       extensions = [ ]

     to::

       extensions = [ 'sphinx.ext.autodoc' ]

   * Change::

       html_theme = 'alabaster'

     to::

       html_theme = 'default'

     To use the theme commonly found in Python documentation (although
     the Sphinx people prefer "Alabaster".)

5. Running "make" without arguments will then give you a list of make
   targets.