ensure all files are reread on every docs build

this fixes the issue where the Stonesense docs were getting ignored

CMakeLists.txt

@@ -478,13 +478,13 @@ if(BUILD_DOCS)
     set_source_files_properties(${SPHINX_OUTPUT} PROPERTIES GENERATED TRUE)
     add_custom_command(OUTPUT ${SPHINX_OUTPUT}
         COMMAND ${SPHINX_EXECUTABLE}
-            -q -b html -d "${CMAKE_BINARY_DIR}/docs/html"
+            -E -q -b html -d "${CMAKE_BINARY_DIR}/docs/html"
             "${CMAKE_CURRENT_SOURCE_DIR}"
             "${CMAKE_CURRENT_SOURCE_DIR}/docs/html"
             -w "${CMAKE_BINARY_DIR}/docs/html/_sphinx-warnings.txt"
             -j auto
         COMMAND ${SPHINX_EXECUTABLE}
-            -q -b text -d "${CMAKE_BINARY_DIR}/docs/text"
+            -E -q -b text -d "${CMAKE_BINARY_DIR}/docs/text"
             "${CMAKE_CURRENT_SOURCE_DIR}"
             "${CMAKE_CURRENT_SOURCE_DIR}/docs/text"
             -w "${CMAKE_BINARY_DIR}/docs/text/_sphinx-warnings.txt"

conf.py

@@ -140,7 +140,7 @@ def write_tool_docs():
         os.makedirs(os.path.join('docs/tools', os.path.dirname(k[0])),
                     mode=0o755, exist_ok=True)
         with open('docs/tools/{}.rst'.format(k[0]), mode) as outfile:
-            if k[0] != 'search':
+            if k[0] != 'search' and k[0] != 'stonesense':
                 outfile.write(label)
             outfile.write(include)
 

docs/build.sh

@@ -11,5 +11,5 @@
 cd $(dirname "$0")
 cd ..
 
-"${SPHINX:-sphinx-build}" -b html -d build/docs/html . docs/html -w build/docs/html/_sphinx-warnings.txt -j "${JOBS:-auto}" "$@"
-"${SPHINX:-sphinx-build}" -b text -d build/docs/text . docs/text -w build/docs/text/_sphinx-warnings.txt -j "${JOBS:-auto}" "$@"
+"${SPHINX:-sphinx-build}" -E -b html -d build/docs/html . docs/html -w build/docs/html/_sphinx-warnings.txt -j "${JOBS:-auto}" "$@"
+"${SPHINX:-sphinx-build}" -E -b text -d build/docs/text . docs/text -w build/docs/text/_sphinx-warnings.txt -j "${JOBS:-auto}" "$@"