doxygen.sh (795B)
1 #!/bin/sh 2 3 # Make sure the doxygen documentation builds without warnings 4 # 5 # Copyright The Mbed TLS Contributors 6 # SPDX-License-Identifier: Apache-2.0 OR GPL-2.0-or-later 7 8 # Abort on errors (and uninitialised variables) 9 set -eu 10 11 . $(dirname "$0")/project_detection.sh 12 13 if in_mbedtls_repo || in_tf_psa_crypto_repo; then :; else 14 echo "Must be run from Mbed TLS root or TF-PSA-Crypto root" >&2 15 exit 1 16 fi 17 18 if $(dirname "$0")/apidoc_full.sh > doc.out 2>doc.err; then :; else 19 cat doc.err 20 echo "FAIL" >&2 21 exit 1; 22 fi 23 24 cat doc.out doc.err | \ 25 grep -v "warning: ignoring unsupported tag" \ 26 > doc.filtered 27 28 if grep -E "(warning|error):" doc.filtered; then 29 echo "FAIL" >&2 30 exit 1; 31 fi 32 33 if in_mbedtls_repo; then 34 make apidoc_clean 35 fi 36 37 rm -f doc.out doc.err doc.filtered