xref: /aosp_15_r20/external/mbedtls/tests/scripts/doxygen.sh (revision 62c56f9862f102b96d72393aff6076c951fb8148)
1*62c56f98SSadaf Ebrahimi#!/bin/sh
2*62c56f98SSadaf Ebrahimi
3*62c56f98SSadaf Ebrahimi# Make sure the doxygen documentation builds without warnings
4*62c56f98SSadaf Ebrahimi#
5*62c56f98SSadaf Ebrahimi# Copyright The Mbed TLS Contributors
6*62c56f98SSadaf Ebrahimi# SPDX-License-Identifier: Apache-2.0 OR GPL-2.0-or-later
7*62c56f98SSadaf Ebrahimi
8*62c56f98SSadaf Ebrahimi# Abort on errors (and uninitialised variables)
9*62c56f98SSadaf Ebrahimiset -eu
10*62c56f98SSadaf Ebrahimi
11*62c56f98SSadaf Ebrahimiif [ -d library -a -d include -a -d tests ]; then :; else
12*62c56f98SSadaf Ebrahimi    echo "Must be run from Mbed TLS root" >&2
13*62c56f98SSadaf Ebrahimi    exit 1
14*62c56f98SSadaf Ebrahimifi
15*62c56f98SSadaf Ebrahimi
16*62c56f98SSadaf Ebrahimiif scripts/apidoc_full.sh > doc.out 2>doc.err; then :; else
17*62c56f98SSadaf Ebrahimi    cat doc.err
18*62c56f98SSadaf Ebrahimi    echo "FAIL" >&2
19*62c56f98SSadaf Ebrahimi    exit 1;
20*62c56f98SSadaf Ebrahimifi
21*62c56f98SSadaf Ebrahimi
22*62c56f98SSadaf Ebrahimicat doc.out doc.err | \
23*62c56f98SSadaf Ebrahimi    grep -v "warning: ignoring unsupported tag" \
24*62c56f98SSadaf Ebrahimi    > doc.filtered
25*62c56f98SSadaf Ebrahimi
26*62c56f98SSadaf Ebrahimiif grep -E "(warning|error):" doc.filtered; then
27*62c56f98SSadaf Ebrahimi    echo "FAIL" >&2
28*62c56f98SSadaf Ebrahimi    exit 1;
29*62c56f98SSadaf Ebrahimifi
30*62c56f98SSadaf Ebrahimi
31*62c56f98SSadaf Ebrahimimake apidoc_clean
32*62c56f98SSadaf Ebrahimirm -f doc.out doc.err doc.filtered
33