2017-11-08 02:05:56 +01:00
|
|
|
#
|
2019-02-05 18:53:16 +01:00
|
|
|
# Top level makefile for documentation build
|
2017-11-08 02:05:56 +01:00
|
|
|
#
|
|
|
|
|
2018-09-04 22:03:50 +02:00
|
|
|
ifndef ZEPHYR_BASE
|
|
|
|
$(error The ZEPHYR_BASE environment variable must be set)
|
|
|
|
endif
|
|
|
|
|
2018-07-10 13:31:18 +02:00
|
|
|
BUILDDIR ?= doc/_build
|
2018-07-13 11:55:54 +02:00
|
|
|
DOC_TAG ?= development
|
|
|
|
SPHINXOPTS ?= -q
|
2017-11-08 02:05:56 +01:00
|
|
|
|
|
|
|
# Documentation targets
|
|
|
|
# ---------------------------------------------------------------------------
|
2019-02-05 18:53:16 +01:00
|
|
|
clean:
|
|
|
|
rm -rf ${BUILDDIR}
|
|
|
|
|
2017-11-08 02:05:56 +01:00
|
|
|
htmldocs:
|
2018-07-19 13:47:45 +02:00
|
|
|
mkdir -p ${BUILDDIR} && cmake -GNinja -DDOC_TAG=${DOC_TAG} -DSPHINXOPTS=${SPHINXOPTS} -B${BUILDDIR} -Hdoc/ && ninja -C ${BUILDDIR} htmldocs
|
2018-09-11 02:27:13 +02:00
|
|
|
|
2019-01-21 19:58:05 +01:00
|
|
|
htmldocs-fast:
|
|
|
|
mkdir -p ${BUILDDIR} && cmake -GNinja -DKCONFIG_TURBO_MODE=1 -DDOC_TAG=${DOC_TAG} -DSPHINXOPTS=${SPHINXOPTS} -B${BUILDDIR} -Hdoc/ && ninja -C ${BUILDDIR} htmldocs
|
|
|
|
|
2018-09-11 02:27:13 +02:00
|
|
|
pdfdocs:
|
|
|
|
mkdir -p ${BUILDDIR} && cmake -GNinja -DDOC_TAG=${DOC_TAG} -DSPHINXOPTS=${SPHINXOPTS} -B${BUILDDIR} -Hdoc/ && ninja -C ${BUILDDIR} pdfdocs
|