numam-dpdk/doc/api/generate_doxygen.sh

#! /bin/sh -e
# SPDX-License-Identifier: BSD-3-Clause
# Copyright 2018 Luca Boccassi <bluca@debian.org>

DOXYCONF=$1
OUTDIR=$2
SCRIPTCSS=$3

# run doxygen, capturing all the header files it processed
doxygen "${DOXYCONF}" > doxygen.out
echo "$OUTDIR: $(awk '/Preprocessing/ {printf("%s ", substr($2, 1, length($2) - 3))}' doxygen.out)" > $OUTDIR.d

"${SCRIPTCSS}" "${OUTDIR}"/doxygen.css
build: generate API documentation with meson Signed-off-by: Luca Boccassi <bluca@debian.org> Acked-by: Bruce Richardson <bruce.richardson@intel.com> 2018-09-11 21:42:36 +01:00			`#! /bin/sh -e`
			`# SPDX-License-Identifier: BSD-3-Clause`
			`# Copyright 2018 Luca Boccassi <bluca@debian.org>`

			`DOXYCONF=$1`
			`OUTDIR=$2`
			`SCRIPTCSS=$3`

doc: add dependency on header files for API doxygen Generate a dependency file for the header files used in the API guide so that the docs can be rebuilt if a header changes. Signed-off-by: Bruce Richardson <bruce.richardson@intel.com> Acked-by: Luca Boccassi <bluca@debian.org> 2020-01-17 11:22:36 +00:00			`# run doxygen, capturing all the header files it processed`
doc: hide verbose doxygen standard output The standard output of doxygen is very verbose, and since ninja mixes stdout and stderr together it makes it difficult to see any warnings from the doxygen run. Therefore, we can just log the standard output to file, and only output the stderr to make warnings clear. Suggested-by: Thomas Monjalon <thomas@monjalon.net> Signed-off-by: Bruce Richardson <bruce.richardson@intel.com> 2020-09-29 17:54:57 +01:00			`doxygen "${DOXYCONF}" > doxygen.out`
doc: add dependency on header files for API doxygen Generate a dependency file for the header files used in the API guide so that the docs can be rebuilt if a header changes. Signed-off-by: Bruce Richardson <bruce.richardson@intel.com> Acked-by: Luca Boccassi <bluca@debian.org> 2020-01-17 11:22:36 +00:00			`echo "$OUTDIR: $(awk '/Preprocessing/ {printf("%s ", substr($2, 1, length($2) - 3))}' doxygen.out)" > $OUTDIR.d`

build: generate API documentation with meson Signed-off-by: Luca Boccassi <bluca@debian.org> Acked-by: Bruce Richardson <bruce.richardson@intel.com> 2018-09-11 21:42:36 +01:00			`"${SCRIPTCSS}" "${OUTDIR}"/doxygen.css`