Remove old comment referencing fixed bug

There was an old comment left regarding this bug:

https://bugs.launchpad.net/pbr/+bug/1260495

which was fixed over a year ago but left over.

This change removes the comment and related extension
and adds the referenced pbr setting.

Change-Id: Ib334c136835a9b5b43cabe13b9616cce45e578e0

doc/source/conf.py

@@ -43,10 +43,6 @@ extensions = ['sphinx.ext.autodoc',
               'sphinx.ext.todo',
               'sphinx.ext.coverage',
               'sphinx.ext.intersphinx',
-              # NOTE(blk-u): Uncomment the [pbr] section in setup.cfg and
-              # remove this Sphinx extension when
-              # https://launchpad.net/bugs/1260495 is fixed.
-              'ext.apidoc',
               'oslosphinx',
               'oslo_config.sphinxconfiggen'
              ]

setup.cfg

@@ -45,6 +45,10 @@ source-dir = doc/source
 build-dir = doc/build
 all_files = 1
 
+[pbr]
+autodoc_tree_index_modules = True
+autodoc_tree_excludes = setup.py
+
 [upload_sphinx]
 upload-dir = doc/build/html