From 628b8caf3cc25d606aa2ccf04f66e2caa742ca35 Mon Sep 17 00:00:00 2001 From: Marc Herbert Date: Tue, 7 Apr 2020 17:02:15 -0700 Subject: [PATCH] CI: travis: add doxygen stage Before this new stage, doxygen was run only in a completely different repo (sof-docs). So it was possible to submit totally broken doxygen changes and get no doxygen feedback at all from CI before merge. Signed-off-by: Marc Herbert --- .travis.yml | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/.travis.yml b/.travis.yml index de06a73814b5..37a897a4b20b 100644 --- a/.travis.yml +++ b/.travis.yml @@ -11,6 +11,7 @@ stages: - test - qemutest - testbench + - doxygen before_install: - docker pull thesofproject/sof && docker tag thesofproject/sof sof @@ -80,3 +81,18 @@ jobs: - ./scripts/docker-run.sh ./scripts/build-tools.sh -t &> /dev/null - ./scripts/docker-run.sh ./scripts/host-build-all.sh - ./scripts/host-testbench.sh + + - stage: doxygen + + before_install: sudo apt-get -y install ninja-build doxygen graphviz + + script: + + # Show ALL warnings. Warnings don't cause doxygen to fail (yet). + - mkdir -p doxybuild && pushd doxybuild && cmake -GNinja -S ../doc && ninja -v doc + - popd + + # Build again (it's very quick) and report a failure in Travis if + # any issue. This time doxygen stops on the first issue. + - printf 'WARN_AS_ERROR = YES\n' >> doc/sof.doxygen.in + - ninja -C doxybuild -v doc