Fixes to enable the jenkins doc job to work

Some of our documentation dependencies were not listed in
test-requires, so the venv environment in tox needs to be
updated to include them.

Then the build_sphinx command looks for configuration settings
in setup.cfg, so those need to be added.

When Sphinx runs in this way, it ends up creating
RST files for every module it finds in the source tree
so it can document the internal APIs. Those generated files
can be ignored by git.

Change-Id: I21b5f9c6c4d4201893bb3bf87f0b61a053b968f5
Signed-off-by: Doug Hellmann <doug.hellmann@dreamhost.com>

.gitignore

@@ -12,3 +12,4 @@ ChangeLog
 dist
 *.egg
 ceilometer/versioninfo
+doc/source/api/*.rst

setup.cfg

@@ -6,3 +6,8 @@ cover-inclusive = true
 verbosity=2
 detailed-errors=1
 where=tests
+
+[build_sphinx]
+all_files = 1
+build-dir = doc/build
+source-dir = doc/source

tox.ini

@@ -24,6 +24,9 @@ deps = pep8==1.1
 commands = pep8 --repeat --show-source ceilometer setup.py bin/ceilometer-agent-central bin/ceilometer-agent-compute bin/ceilometer-collector bin/ceilometer-api tests
 
 [testenv:venv]
+deps = -r{toxinidir}/tools/test-requires
+       -r{toxinidir}/tools/pip-requires
+	   sphinxcontrib-httpdomain
 commands = {posargs}
 
 [testenv:py26-folsom]