diff options
Diffstat (limited to 'scripts/make-doc.sh')
-rwxr-xr-x | scripts/make-doc.sh | 42 |
1 files changed, 42 insertions, 0 deletions
diff --git a/scripts/make-doc.sh b/scripts/make-doc.sh new file mode 100755 index 0000000..d41e234 --- /dev/null +++ b/scripts/make-doc.sh @@ -0,0 +1,42 @@ +#!/bin/bash +# SPDX-License-Identifier: GPL-3.0-or-later +cd "$(dirname ${0})/.." + +pushd doc +doxygen +popd + +SPHINX=$(command -v sphinx-build-3) +if [ $? -ne 0 ]; then + SPHINX=$(command -v sphinx-build) +fi + +set -o errexit -o nounset + +rm -rf doc/html +${SPHINX} ${@} -b html -d doc/.doctrees doc doc/html + +if command -v makeinfo &>/dev/null; then + rm -rf doc/texinfo + ${SPHINX} ${@} -b texinfo -d doc/.doctrees doc doc/texinfo + + # Sphinx < 2 doesn't create a separate directory for figures, so if + # necessary move them to the correct location and update the references in + # the generated Texinfo file + if [ ! -d doc/texinfo/knot-resolver-figures ]; then + cd doc/texinfo + mkdir knot-resolver-figures + mv *.png *.svg knot-resolver-figures/ + sed -e 's/\(@image{\)/\1knot-resolver-figures\//' \ + knot-resolver.texi > knot-resolver.texi.tmp + mv knot-resolver.texi.tmp knot-resolver.texi + cd ../.. + fi + + make -C doc/texinfo info + + mkdir doc/texinfo/.install + mv doc/texinfo/knot-resolver.info \ + doc/texinfo/knot-resolver-figures \ + doc/texinfo/.install/ +fi |