Hook docstrings into the published docs

Fixes bug #1182842

We've always had pretty decent documentation coverage in the docstrings
but have never taken the time to hook them into the published docs.

This is a first-cut at doing that. There's plenty of rough edges, but
it's a good start.

Change-Id: I62a509e7d6e156e9b67e75bef9da68fbfc4601ac

doc/source/cfg.rst

@@ -0,0 +1,5 @@
+--------------
+The cfg Module
+--------------
+
+.. automodule:: oslo.config.cfg

doc/source/configopts.rst

@@ -0,0 +1,8 @@
+--------------------
+The ConfigOpts Class
+--------------------
+
+.. currentmodule:: oslo.config.cfg
+
+.. autoclass:: ConfigOpts
+   :members:

doc/source/exceptions.rst

@@ -0,0 +1,16 @@
+----------
+Exceptions
+----------
+
+.. currentmodule:: oslo.config.cfg
+
+.. autoexception:: Error
+.. autoexception:: ArgsAlreadyParsedError
+.. autoexception:: NoSuchOptError
+.. autoexception:: NoSuchGroupError
+.. autoexception:: DuplicateOptError
+.. autoexception:: RequiredOptError
+.. autoexception:: TemplateSubstitutionError
+.. autoexception:: ConfigFilesNotFoundError
+.. autoexception:: ConfigFileParseError
+.. autoexception:: ConfigFileValueError

doc/source/helpers.rst

@@ -0,0 +1,8 @@
+----------------
+Helper Functions
+----------------
+
+.. currentmodule:: oslo.config.cfg
+
+.. autofunction:: find_config_files
+.. autofunction:: set_defaults

doc/source/index.rst

@@ -5,12 +5,17 @@ An OpenStack library for parsing configuration options from the command
 line and configuration files.
 
 Contents
---------
+========
 
 .. toctree::
-   :maxdepth: 1
+   :maxdepth: 2
 
-   api/autoindex
+   cfg
+   opts
+   configopts
+   helpers
+   parser
+   exceptions
 
 Release Notes
 =============

doc/source/opts.rst

@@ -0,0 +1,17 @@
+------------------
+Option Definitions
+------------------
+
+.. currentmodule:: oslo.config.cfg
+
+.. autoclass:: Opt
+.. autoclass:: StrOpt
+.. autoclass:: BoolOpt
+.. autoclass:: IntOpt
+.. autoclass:: FloatOpt
+.. autoclass:: ListOpt
+.. autoclass:: DictOpt
+.. autoclass:: MultiStrOpt
+.. autoclass:: DeprecatedOpt
+.. autoclass:: SubCommandOpt
+.. autoclass:: OptGroup

doc/source/parser.rst

@@ -0,0 +1,11 @@
+------------
+File Parsing
+------------
+
+.. autoclass:: oslo.config.iniparser.BaseParser
+
+.. autoclass:: oslo.config.cfg.ConfigParser
+   :members: parse
+
+.. autoclass:: oslo.config.cfg.MultiConfigParser
+   :members: read, get