From c345ea8300ec35f72b3aa83e3b22823d8467f486 Mon Sep 17 00:00:00 2001
From: Oliver Hamlet <oliver.hamlet@gmail.com>
Date: Thu, 22 Sep 2016 08:03:43 +0100
Subject: [PATCH] Build docs on CI before packaging

---
 .travis.yml  | 11 +++++++++++
 appveyor.yml |  3 +++
 2 files changed, 14 insertions(+)

diff --git a/.travis.yml b/.travis.yml
index bc2b99b3..5a0a8158 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -47,6 +47,16 @@ install:
   - bower install
   - chmod +x scripts/travis/install_boost.sh
   - scripts/travis/install_boost.sh
+  # Install packages for generating documentation
+  - pip install --user sphinx breathe sphinx_rtd_theme
+  # Add sphinx-build to PATH
+  - export PATH="$HOME/.local/bin:$PATH"
+  # Don't install Doxygen from the repositories, it also gets the LaTeX packages
+  # so is a ~ 700 MB download.
+  - wget ftp://ftp.stack.nl/pub/users/dimitri/doxygen-1.8.12.linux.bin.tar.gz
+  - tar -xf doxygen-1.8.12.linux.bin.tar.gz
+  # Add Doxygen binary path to PATH
+  - export PATH="$PWD/doxygen-1.8.12/bin:$PATH"
 
 before_script:
   # Move into the cloned LOOT repo build path.
@@ -67,6 +77,7 @@ after_success:
   # Get the full repo history before trying to run the archiver.
   - git fetch --unshallow
   - node scripts/potomo.js
+  - sphinx-build -b html docs build/docs/html
   - node scripts/archive.js
   # Need to replace the HEAD branch descriptor in the archive filenames
   - for ARCHIVE in build/*.tar.xz; do mv $ARCHIVE $(echo $ARCHIVE | sed "s/HEAD/$TRAVIS_BRANCH/"); done
diff --git a/appveyor.yml b/appveyor.yml
index 466d3189..c0ba9456 100644
--- a/appveyor.yml
+++ b/appveyor.yml
@@ -16,6 +16,8 @@ environment:
     secure: yoODjVeYw01Vg2idJgxMBOkyII/TO3yb6OZfxtzBh/F5z3ZTDW6CHBOiH4AyiX7Y
 
 install:
+  - choco install doxygen.portable
+  - python -m pip install sphinx breathe sphinx_rtd_theme
   - npm install
   - .\node_modules\.bin\bower install
   - ps: .\scripts\appveyor\install_boost.ps1
@@ -37,6 +39,7 @@ test_script:
 
 after_test:
   - cd %APPVEYOR_BUILD_FOLDER%
+  - C:\Python27\Scripts\sphinx-build -b html docs build\docs\html
   - node scripts\potomo.js
   - node scripts\archive.js
   # AppVeyor checks out a specific commit, but that means the archive script