replace the hard-coded history list with an auto-generated one

Replace the hand curated list of changes with the one generated by pbr
automatically.

At the same time, change the toctree settings in index.rst to avoid
showing every release of stevedore at the top level and to clean up the
amount of nesting showing for other entries.

Change-Id: I3fb9306c0ca3ce6ed9681ffeaa8b9b8ed0f2bd7c

doc/source/history.rst

@@ -1,116 +1 @@
-=========
- History
-=========
-
-0.14
-
-- Provide an option to control requirements checking when loading
-  plugins, and disable it by default. This removes protection against
-  loading the wrong version of a plugin, or that plugin's
-  dependencies.
-
-0.13
-
-- Deprecate ``TestExtensionManager`` and replace with
-  ``make_test_instance()`` class method to provide test classes that
-  behave more like the production class, while still allowing the
-  extensions to be injected for testing. (contributed by drocco-007)
-- Include a work-around to avoid a cpython bug with atexit
-  (#15881). (contributed by philiptzou)
-- Update documentation to refer to setuptools instead of
-  distribute. (contributed by westurner)
-- Add pypy to the list of default test configurations.
-
-0.12
-
-- Fixes an exception when reporting on an error where multiple drivers
-  have the same name (:issue:`25`, solution provided by clayg).
-- Switch packaging to use pbr_.
-- Add ``map_method()`` API to controllers.
-
-.. _pbr: https://github.com/openstack-dev/pbr
-
-0.11
-
-- Fixes logging configuration under Python 2.6 with a NullHandler.
-  (:issue:`2`)
-
-0.10
-
-- Adds ``propagate_map_exceptions`` parameter to all of the extension
-  managers which specifies whether exceptions are propagated up 
-  through the map call or logged and then ignored. The default is to
-  preserve the current behavior of logging and ignoring exceptions.
-  Christopher Yeoh <cyeoh@au1.ibm.com>
-
-0.9
-
-- Add ``name_order`` parameter to
-  :class:`~stevedore.named.NamedExtensionManager` to coerce
-  :func:`map` into processing the extensions in the order they are
-  named when the manager is created, instead of the random order
-  they may have been loaded. Contributed by Daniel Rocco.
-- Change the
-  :class:`~stevedore.dispatch.NamedDispatchExtensionManager` to ignore
-  missing extensions (:issue:`14`).
-- Add ``__getitem__`` to
-  :class:`~stevedore.extension.ExtensionManager` for looking up
-  individual plugins by name (:issue:`15`).
-- Start working on the tutorial, :doc:`tutorial/index`.
-- Remove dependency on distribute, now that it is merged back into
-  setuptools 0.7 (:issue:`19`).
-
-0.8
-
-  - Ignore AssertionError exceptions generated when plugins are
-    loaded.
-  - Update :class:`~stevedore.named.NamedExtensionManager` to check
-    the name of a plugin before loading its code to avoid importing
-    anything we are not going to use.
-
-0.7.2
-
-  - Fix logging support for Python 2.6.
-
-0.7.1
-
-  - Fix an issue with logging configuration.
-
-0.7
-
-  - Add memoization to the entrypoint scanning code in
-    :class:`~stevedore.extension.ExtensionManager` to avoid
-    performance issues in situations where lots of managers are
-    instantiated with the same namespace argument.
-
-0.6
-
-  - Change the :class:`~stevedore.enabled.EnabledExtensionManager` to
-    load the extension before calling the check function so the plugin
-    can be asked if it should be enabled.
-
-0.5
-
-  - Add :class:`~stevedore.tests.manager.TestExtensionManager` for
-    writing tests for classes that use extension managers.
-
-0.4
-
-  - Removed the ``name`` argument to plugin constructors.
-  - Added ``driver`` property to :class:`~stevedore.driver.DriverManager`.
-
-0.3
-
-  - Added dispatch managers for selecting among a set of plugins at
-    runtime instead of load time.
-  - Added ``__call__`` method to
-    :class:`~stevedore.driver.DriverManager` so it can be invoked in a
-    more natural fashion for a single plugin.
-
-0.2
-
-  - Added documentation
-
-0.1
-
-  - First public release
+.. include:: ../../ChangeLog

doc/source/index.rst

@@ -16,6 +16,7 @@ Contents:
 
 .. toctree::
    :glob:
+   :maxdepth: 2
 
    patterns_loading
    patterns_enabling
@@ -24,6 +25,10 @@ Contents:
    sphinxext
    install
    essays/*
+
+.. toctree::
+   :maxdepth: 1
+
    history
 
 .. _setuptools entry points: http://packages.python.org/setuptools/pkg_resources.html#convenience-api