ci/test-documentation.sh

   1 #!/usr/bin/env bash
   2 #
   3 # Perform sanity checks on documentation and build it.
   4 #
   5
   6 . ${0%/*}/lib-travisci.sh
   7
   8 gem install asciidoctor
   9
  10 make check-builtins
  11 make check-docs
  12
  13 # Build docs with AsciiDoc
  14 make --jobs=2 doc > >(tee stdout.log) 2> >(tee stderr.log >&2)
  15 ! test -s stderr.log
  16 test -s Documentation/git.html
  17 test -s Documentation/git.xml
  18 test -s Documentation/git.1
  19 grep '<meta name="generator" content="AsciiDoc ' Documentation/git.html
  20
  21 rm -f stdout.log stderr.log
  22 check_unignored_build_artifacts
  23
  24 # Build docs with AsciiDoctor
  25 make clean
  26 make --jobs=2 USE_ASCIIDOCTOR=1 doc > >(tee stdout.log) 2> >(tee stderr.log >&2)
  27 sed '/^GIT_VERSION = / d' stderr.log
  28 ! test -s stderr.log
  29 test -s Documentation/git.html
  30 grep '<meta name="generator" content="Asciidoctor ' Documentation/git.html
  31
  32 rm -f stdout.log stderr.log
  33 check_unignored_build_artifacts
  34
  35 save_good_tree