summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJenkins <jenkins@review.openstack.org>2015-09-24 22:05:38 +0000
committerGerrit Code Review <review@openstack.org>2015-09-24 22:05:38 +0000
commit88f3e6b4a8cd3d84c2236168d3d894c1c581de51 (patch)
treedb66d40813f86dbc78e7638ca2e9b58b5f005fcc
parent6450edb58b89b992ef8a1d10622aa9807cc0e7da (diff)
parent0b3aee8cc6d5c373bcba74330f0fea8f0e4e4b26 (diff)
downloadoslo-db-88f3e6b4a8cd3d84c2236168d3d894c1c581de51.tar.gz
Merge "Autogenerate the module docs"
-rw-r--r--.gitignore1
-rw-r--r--doc/source/api/api.rst8
-rw-r--r--doc/source/api/concurrency.rst8
-rw-r--r--doc/source/api/exception.rst8
-rw-r--r--doc/source/api/index.rst12
-rw-r--r--doc/source/api/options.rst8
-rw-r--r--doc/source/api/sqlalchemy/index.rst9
-rw-r--r--doc/source/api/sqlalchemy/migration.rst8
-rw-r--r--doc/source/api/sqlalchemy/models.rst8
-rw-r--r--doc/source/api/sqlalchemy/provision.rst8
-rw-r--r--doc/source/api/sqlalchemy/session.rst8
-rw-r--r--doc/source/api/sqlalchemy/test_base.rst8
-rw-r--r--doc/source/api/sqlalchemy/test_migrations.rst8
-rw-r--r--doc/source/api/sqlalchemy/utils.rst8
-rwxr-xr-xdoc/source/conf.py3
-rw-r--r--doc/source/index.rst6
-rw-r--r--setup.cfg4
17 files changed, 10 insertions, 113 deletions
diff --git a/.gitignore b/.gitignore
index a447b46..a24c644 100644
--- a/.gitignore
+++ b/.gitignore
@@ -18,3 +18,4 @@ ChangeLog
.project
.pydevproject
oslo.db.egg-info/
+doc/source/api
diff --git a/doc/source/api/api.rst b/doc/source/api/api.rst
deleted file mode 100644
index d58cbaf..0000000
--- a/doc/source/api/api.rst
+++ /dev/null
@@ -1,8 +0,0 @@
-=============
- oslo_db.api
-=============
-
-.. automodule:: oslo_db.api
- :members:
- :undoc-members:
- :show-inheritance:
diff --git a/doc/source/api/concurrency.rst b/doc/source/api/concurrency.rst
deleted file mode 100644
index d5775e7..0000000
--- a/doc/source/api/concurrency.rst
+++ /dev/null
@@ -1,8 +0,0 @@
-=====================
- oslo_db.concurrency
-=====================
-
-.. automodule:: oslo_db.concurrency
- :members:
- :undoc-members:
- :show-inheritance:
diff --git a/doc/source/api/exception.rst b/doc/source/api/exception.rst
deleted file mode 100644
index 329525b..0000000
--- a/doc/source/api/exception.rst
+++ /dev/null
@@ -1,8 +0,0 @@
-===================
- oslo_db.exception
-===================
-
-.. automodule:: oslo_db.exception
- :members:
- :undoc-members:
- :show-inheritance:
diff --git a/doc/source/api/index.rst b/doc/source/api/index.rst
deleted file mode 100644
index 124e451..0000000
--- a/doc/source/api/index.rst
+++ /dev/null
@@ -1,12 +0,0 @@
-=====
- API
-=====
-
-.. toctree::
- :maxdepth: 2
-
- api
- concurrency
- exception
- options
- sqlalchemy/index
diff --git a/doc/source/api/options.rst b/doc/source/api/options.rst
deleted file mode 100644
index 4216cda..0000000
--- a/doc/source/api/options.rst
+++ /dev/null
@@ -1,8 +0,0 @@
-=================
- oslo_db.options
-=================
-
-.. automodule:: oslo_db.options
- :members:
- :undoc-members:
- :show-inheritance:
diff --git a/doc/source/api/sqlalchemy/index.rst b/doc/source/api/sqlalchemy/index.rst
deleted file mode 100644
index 5e2496e..0000000
--- a/doc/source/api/sqlalchemy/index.rst
+++ /dev/null
@@ -1,9 +0,0 @@
-====================
- oslo_db.sqlalchemy
-====================
-
-.. toctree::
- :maxdepth: 1
- :glob:
-
- *
diff --git a/doc/source/api/sqlalchemy/migration.rst b/doc/source/api/sqlalchemy/migration.rst
deleted file mode 100644
index 6c7ee46..0000000
--- a/doc/source/api/sqlalchemy/migration.rst
+++ /dev/null
@@ -1,8 +0,0 @@
-==============================
- oslo_db.sqlalchemy.migration
-==============================
-
-.. automodule:: oslo_db.sqlalchemy.migration
- :members:
- :undoc-members:
- :show-inheritance:
diff --git a/doc/source/api/sqlalchemy/models.rst b/doc/source/api/sqlalchemy/models.rst
deleted file mode 100644
index 5c6f461..0000000
--- a/doc/source/api/sqlalchemy/models.rst
+++ /dev/null
@@ -1,8 +0,0 @@
-===========================
- oslo_db.sqlalchemy.models
-===========================
-
-.. automodule:: oslo_db.sqlalchemy.models
- :members:
- :undoc-members:
- :show-inheritance:
diff --git a/doc/source/api/sqlalchemy/provision.rst b/doc/source/api/sqlalchemy/provision.rst
deleted file mode 100644
index 0ae5ff1..0000000
--- a/doc/source/api/sqlalchemy/provision.rst
+++ /dev/null
@@ -1,8 +0,0 @@
-==============================
- oslo_db.sqlalchemy.provision
-==============================
-
-.. automodule:: oslo_db.sqlalchemy.provision
- :members:
- :undoc-members:
- :show-inheritance:
diff --git a/doc/source/api/sqlalchemy/session.rst b/doc/source/api/sqlalchemy/session.rst
deleted file mode 100644
index b6635bd..0000000
--- a/doc/source/api/sqlalchemy/session.rst
+++ /dev/null
@@ -1,8 +0,0 @@
-============================
- oslo_db.sqlalchemy.session
-============================
-
-.. automodule:: oslo_db.sqlalchemy.session
- :members:
- :undoc-members:
- :show-inheritance:
diff --git a/doc/source/api/sqlalchemy/test_base.rst b/doc/source/api/sqlalchemy/test_base.rst
deleted file mode 100644
index 0eb6878..0000000
--- a/doc/source/api/sqlalchemy/test_base.rst
+++ /dev/null
@@ -1,8 +0,0 @@
-==============================
- oslo_db.sqlalchemy.test_base
-==============================
-
-.. automodule:: oslo_db.sqlalchemy.test_base
- :members:
- :undoc-members:
- :show-inheritance:
diff --git a/doc/source/api/sqlalchemy/test_migrations.rst b/doc/source/api/sqlalchemy/test_migrations.rst
deleted file mode 100644
index afb24ff..0000000
--- a/doc/source/api/sqlalchemy/test_migrations.rst
+++ /dev/null
@@ -1,8 +0,0 @@
-====================================
- oslo_db.sqlalchemy.test_migrations
-====================================
-
-.. automodule:: oslo_db.sqlalchemy.test_migrations
- :members:
- :undoc-members:
- :show-inheritance:
diff --git a/doc/source/api/sqlalchemy/utils.rst b/doc/source/api/sqlalchemy/utils.rst
deleted file mode 100644
index e657636..0000000
--- a/doc/source/api/sqlalchemy/utils.rst
+++ /dev/null
@@ -1,8 +0,0 @@
-==========================
- oslo_db.sqlalchemy.utils
-==========================
-
-.. automodule:: oslo_db.sqlalchemy.utils
- :members:
- :undoc-members:
- :show-inheritance:
diff --git a/doc/source/conf.py b/doc/source/conf.py
index 7b14fdb..aa53ed0 100755
--- a/doc/source/conf.py
+++ b/doc/source/conf.py
@@ -58,6 +58,9 @@ add_module_names = True
# The name of the Pygments (syntax highlighting) style to use.
pygments_style = 'sphinx'
+# A list of ignored prefixes for module index sorting.
+modindex_common_prefix = ['oslo_db.']
+
# -- Options for HTML output --------------------------------------------------
# The theme to use for HTML and HTML Help pages. Major themes that come with
diff --git a/doc/source/index.rst b/doc/source/index.rst
index 8eefaab..6532cf8 100644
--- a/doc/source/index.rst
+++ b/doc/source/index.rst
@@ -18,12 +18,12 @@ API Documentation
=================
.. toctree::
- :maxdepth: 2
+ :maxdepth: 1
- api/index
+ api/autoindex
Indices and tables
-------------------
+==================
* :ref:`genindex`
* :ref:`modindex`
diff --git a/setup.cfg b/setup.cfg
index abb016b..649550b 100644
--- a/setup.cfg
+++ b/setup.cfg
@@ -63,4 +63,6 @@ fixtures =
# NOTE(viktors): uncomment ``warnerrors`` line, when setup.cfg we then
# want to treat sphinx warnings as errors
# warnerrors = True
-#autodoc_index_modules = True
+autodoc_index_modules = True
+autodoc_exclude_modules =
+ oslo_db.tests.* \ No newline at end of file