summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorDoug Hellmann <doug@doughellmann.com>2015-05-16 15:13:31 -0400
committerDoug Hellmann <doug@doughellmann.com>2015-06-03 11:40:57 +0000
commit0a8c5145d4d9e82aa18729ff03a38fc725a02d1b (patch)
treeac1883a72b80e1c44feb5533305985552924078d /doc
parent5b4038ce37a63befce191007fc3a71a6d917e0e7 (diff)
downloadoslo-messaging-0a8c5145d4d9e82aa18729ff03a38fc725a02d1b.tar.gz
Add drivers to the documentation
Use stevedore.sphinxext to populate a new page listing all available drivers. Add docstrings to the driver classes, including references to more extensive documentation if it is available. Depends-on: I1a24f9326b4e54174d9dc0ae366315fe29c3ac1b Depends-on: Ie715f98fe0d3cba8b2f4f6235e7c2b6f79be7ea0 Change-Id: Ief0aa05e6deba0126d63faf13497d0fe0539e08d
Diffstat (limited to 'doc')
-rw-r--r--doc/source/conf.py6
-rw-r--r--doc/source/drivers.rst6
-rw-r--r--doc/source/index.rst1
3 files changed, 12 insertions, 1 deletions
diff --git a/doc/source/conf.py b/doc/source/conf.py
index b55a285..825fc27 100644
--- a/doc/source/conf.py
+++ b/doc/source/conf.py
@@ -8,7 +8,11 @@ sys.path.insert(0, os.path.abspath('../..'))
# Add any Sphinx extension module names here, as strings. They can be
# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
-extensions = ['sphinx.ext.autodoc', 'oslosphinx']
+extensions = [
+ 'sphinx.ext.autodoc',
+ 'oslosphinx',
+ 'stevedore.sphinxext',
+]
# autodoc generation is a bit aggressive and a nuisance when doing heavy
# text edit cycles.
diff --git a/doc/source/drivers.rst b/doc/source/drivers.rst
new file mode 100644
index 0000000..21b021a
--- /dev/null
+++ b/doc/source/drivers.rst
@@ -0,0 +1,6 @@
+===================
+ Available Drivers
+===================
+
+.. list-plugins:: oslo.messaging.drivers
+ :detailed:
diff --git a/doc/source/index.rst b/doc/source/index.rst
index c9c45b9..775f5a8 100644
--- a/doc/source/index.rst
+++ b/doc/source/index.rst
@@ -21,6 +21,7 @@ Contents
exceptions
opts
conffixture
+ drivers
AMQP1.0
zmq_driver
FAQ