From 0d0b0ce10e73081c64c70a9d9b19fc7ce6b02bcd Mon Sep 17 00:00:00 2001 From: Gerard Marull-Paretas Date: Wed, 16 Jun 2021 23:49:41 +0200 Subject: [PATCH] doc: make: adjust Makefile Adjust Makefile according to latest CMake changes. Signed-off-by: Gerard Marull-Paretas --- .github/workflows/doc-build.yml | 3 +-- doc/Makefile | 29 +++++++++++++++-------------- 2 files changed, 16 insertions(+), 16 deletions(-) diff --git a/.github/workflows/doc-build.yml b/.github/workflows/doc-build.yml index 70ed2dbbe01..55f6b6248d9 100644 --- a/.github/workflows/doc-build.yml +++ b/.github/workflows/doc-build.yml @@ -54,8 +54,7 @@ jobs: - name: build-docs run: | - source zephyr-env.sh - SPHINXOPTS="-q -W -j auto" make -C doc htmldocs + SPHINXOPTS="-q -W -j auto" make -C doc html tar cvf htmldocs.tar --directory=./doc/_build html - name: upload-build diff --git a/doc/Makefile b/doc/Makefile index af98dba4c93..07676827151 100644 --- a/doc/Makefile +++ b/doc/Makefile @@ -1,30 +1,31 @@ -# -# Top level makefile for documentation build -# +# ------------------------------------------------------------------------------ +# Makefile for documentation build +# SPDX-License-Identifier: Apache-2.0 BUILDDIR ?= _build DOC_TAG ?= development SPHINXOPTS ?= -j auto KCONFIG_TURBO_MODE ?= 0 +# ------------------------------------------------------------------------------ # Documentation targets -# --------------------------------------------------------------------------- -.PHONY: clean htmldocs htmldocs-fast pdfdocs doxygen +.PHONY: configure clean html html-fast latex pdf doxygen -htmldocs-fast: - ${MAKE} htmldocs KCONFIG_TURBO_MODE=1 +html-fast: + ${MAKE} html KCONFIG_TURBO_MODE=1 -htmldocs pdfdocs doxygen: configure - cmake --build ${BUILDDIR} -- $@ # -v # VERBOSE=1 +html latex pdf doxygen: configure + cmake --build ${BUILDDIR} --target $@ -# Run CMake every time cause it's quick and re-configures TURBO_MODE if -# needed -.PHONY: configure configure: - cmake -GNinja -B${BUILDDIR} -S. -DDOC_TAG=${DOC_TAG} \ + cmake \ + -GNinja \ + -B${BUILDDIR} \ + -S. \ + -DDOC_TAG=${DOC_TAG} \ -DSPHINXOPTS="${SPHINXOPTS}" \ -DKCONFIG_TURBO_MODE=${KCONFIG_TURBO_MODE} clean: - rm -rf ${BUILDDIR} + cmake --build ${BUILDDIR} --target clean