No new/removed modules when building docs

[Florian Wilhelm]

When using sphinx-apidoc for the automatic generation of Sphinx sources, i.e. the autodoc_index_modules = False in setup.cfg, added or removed modules files are not included/removed when running "python setup.py docs". This is most likely due to the fact that the tool sphinx-apidoc itself does not regenerate the rst files if the target directory docs/api exists. One has to remove the directory docs/api manually in order to see new included modules or get rid of removed module files. For most users this behavior is annoying and it would be nice to have an PBR option like clean_autodoc in setup.cfg that removes the docs/api directory everytime before calling sphinx-apidoc.

[Ben Nemec (bnemec)]

As a workaround for this, some projects have started to remove the entire build directory in tox before doing their doc builds. It makes the build take a little longer, but it avoids problems like this.