From 2eaf6b3aff5f8c6e94ee2254ac48b2b6b00f35a1 Mon Sep 17 00:00:00 2001
From: Andreas Jaeger <aj@suse.com>
Date: Sat, 27 Oct 2018 16:48:26 +0200
Subject: [PATCH] tox: Stop building *all* docs in 'docs'

The 'docs' target currently builds the documentation trees in 'api-ref'
and 'api-guide', in addition to 'doc'. This massively increases the
amount of time docs take to build both locally and in the gate. It's
not necessary for gate, since separate jobs take care of the other
documents for barbican.  As such, we should stop doing it.

For users that *do* care about this (for whatever reason) a new
'all-docs' target is included.

Change-Id: I3aa314f8643fcb4da93f8642034edddc2145bc32
---
 tox.ini | 14 ++++++++++----
 1 file changed, 10 insertions(+), 4 deletions(-)

diff --git a/tox.ini b/tox.ini
index b406345e..f6ac9145 100644
--- a/tox.ini
+++ b/tox.ini
@@ -82,12 +82,9 @@ commands = oslopolicy-sample-generator --config-file=config-generator/policy.con
 
 [testenv:docs]
 basepython = python3
-description = Builds api-ref, api-guide, releasenotes and devdocs
+description = Builds main documention
 commands =
   {[testenv:devdocs]commands}
-  {[testenv:api-guide]commands}
-  {[testenv:api-ref]commands}
-  {[testenv:releasenotes]commands}
 
 [testenv:api-guide]
 basepython = python3
@@ -112,6 +109,15 @@ commands =
   rm -rf releasenotes/build
   sphinx-build -a -E -W -d releasenotes/build/doctrees -b html releasenotes/source releasenotes/build/html
 
+[testenv:all-docs]
+basepython = python3
+description = Builds all docouments
+commands =
+  {[testenv:devdocs]commands}
+  {[testenv:api-guide]commands}
+  {[testenv:api-ref]commands}
+  {[testenv:releasenotes]commands}
+
 [testenv:devdocs]
 basepython = python3
 description = Builds developer documentation