add sphinx instructions to build API reference docs

Change-Id: I216d6e8ef7afa7c1de47f28a6e33ca0a10975912
Signed-off-by: Doug Hellmann <doug@doughellmann.com>

.gitignore

@@ -53,3 +53,4 @@ ChangeLog
 
 # reno build
 releasenotes/build
+/doc/source/reference/api/

doc/source/reference/index.rst

@@ -2,11 +2,7 @@
  API
 =====
 
-.. Use autodoc directives to describe the *public* modules and classes
-   in the library.
+.. toctree::
+   :maxdepth: 2
 
-   If the modules are completely unrelated, create an api subdirectory
-   and use a separate file for each (see oslo.utils).
-
-   If there is only one submodule, a single api.rst file like this
-   sufficient (see oslo.i18n).
+   api/autoindex

setup.cfg

@@ -22,6 +22,13 @@ classifier =
 packages =
     oslo_privsep
 
+[pbr]
+autodoc_index_modules = True
+api_doc_dir = reference/api
+autodoc_exclude_modules =
+  oslo_privsep.tests.*
+  oslo_privsep._*
+
 [build_sphinx]
 source-dir = doc/source
 build-dir = doc/build