3cf4e2f933
The hw feature generation takes a long time. The HW_FEATURES_TURBO_MODE option completely disables hw feature generation. Add a new option HW_FEATURES_VENDOR_FILTER to be able to selectively enable hw feature generation only for a given list of vendors. This option is useful when working on board documentation pages. Signed-off-by: Aksel Skauge Mellbye <aksel.mellbye@silabs.com>
42 lines
1.2 KiB
Makefile
42 lines
1.2 KiB
Makefile
# ------------------------------------------------------------------------------
|
|
# Makefile for documentation build
|
|
# SPDX-License-Identifier: Apache-2.0
|
|
|
|
BUILDDIR ?= _build
|
|
DOC_TAG ?= development
|
|
SPHINXOPTS ?= -j auto -W --keep-going -T
|
|
SPHINXOPTS_EXTRA ?=
|
|
LATEXMKOPTS ?= -halt-on-error -no-shell-escape
|
|
DT_TURBO_MODE ?= 0
|
|
HW_FEATURES_TURBO_MODE ?= 0
|
|
HW_FEATURES_VENDOR_FILTER ?=
|
|
|
|
# ------------------------------------------------------------------------------
|
|
# Documentation targets
|
|
|
|
.PHONY: configure clean html html-fast html-live html-live-fast latex pdf doxygen
|
|
|
|
html-fast:
|
|
${MAKE} html DT_TURBO_MODE=1 HW_FEATURES_TURBO_MODE=1
|
|
|
|
html-live-fast:
|
|
${MAKE} html-live DT_TURBO_MODE=1 HW_FEATURES_TURBO_MODE=1
|
|
|
|
html html-live latex pdf linkcheck doxygen: configure
|
|
cmake --build ${BUILDDIR} --target $@
|
|
|
|
configure:
|
|
cmake \
|
|
-GNinja \
|
|
-B${BUILDDIR} \
|
|
-S. \
|
|
-DDOC_TAG=${DOC_TAG} \
|
|
-DSPHINXOPTS="${SPHINXOPTS}" \
|
|
-DSPHINXOPTS_EXTRA="${SPHINXOPTS_EXTRA}" \
|
|
-DLATEXMKOPTS="${LATEXMKOPTS}" \
|
|
-DDT_TURBO_MODE=${DT_TURBO_MODE} \
|
|
-DHW_FEATURES_TURBO_MODE=${HW_FEATURES_TURBO_MODE} \
|
|
-DHW_FEATURES_VENDOR_FILTER=${HW_FEATURES_VENDOR_FILTER}
|
|
|
|
clean:
|
|
cmake --build ${BUILDDIR} --target clean
|