From 2557d66fa4e515ac1e26fe68ed63c8339c253e9a Mon Sep 17 00:00:00 2001
From: Daniel Watkins <daniel.watkins@canonical.com>
Date: Fri, 12 Jun 2015 17:12:22 +0100
Subject: [PATCH] Clean up stale auto-generated autodoc files.

This avoid modules that have been moved/removed from continuing to have
documentation generated for them.  We use git clean to allow us to have
other files in there.

Possibly not an issue on the build hosts, but definitely irritating
locally.

Change-Id: I3403e8227913904a25b6a0866adfcc628d60419e
---
 doc/source/api/README | 3 +++
 tox.ini               | 2 ++
 2 files changed, 5 insertions(+)

diff --git a/doc/source/api/README b/doc/source/api/README
index 3bb628f5..643cd1e0 100644
--- a/doc/source/api/README
+++ b/doc/source/api/README
@@ -1 +1,4 @@
 Don't put files in here, it's intended only for auto-generated output!
+
+Specifically, files which aren't known to git will be cleaned out of
+this directory before the docs are generated by tox.
diff --git a/tox.ini b/tox.ini
index 9621c452..7cddb181 100644
--- a/tox.ini
+++ b/tox.ini
@@ -25,7 +25,9 @@ commands = {envpython} {toxinidir}/tools/noproxy nosetests --with-coverage --cov
 commands = flake8 {posargs}
 
 [testenv:docs]
+whitelist_externals = git
 commands =
+    git clean -fx doc/source/api
     python setup.py build_sphinx
     doc8 doc/source