98f8961106
The test target called make with the `-K` flag, which is not valid. Change it to `-k` (keep going if some targets fail) which is what was probably intended. It also tried to build the `doctest` target from Makefile.sphinx, which results in an error. Further investigation reveals that this is because the sphinx doctest extension was not enabled in conf.py. However, from the documentation of doctest [1], it seems like it is intended to ensure that documentation containing Python snippets along with the expected output of the snippet remain in sync, which is something that we probably don't need. So, remove the call to it. [1] https://www.sphinx-doc.org/en/master/usage/extensions/doctest.html" Change-Id: Id514950b4486ed8644d078af222c96ed711fc8f9 Signed-off-by: Nicholas Chin <nic.c3.14@gmail.com> Reviewed-on: https://review.coreboot.org/c/coreboot/+/83381 Reviewed-by: Nico Huber <nico.h@gmx.de> Tested-by: build bot (Jenkins) <no-reply@coreboot.org> Reviewed-by: Elyes Haouas <ehaouas@noos.fr>
50 lines
1.3 KiB
Makefile
50 lines
1.3 KiB
Makefile
## SPDX-License-Identifier: GPL-2.0-only
|
|
#
|
|
# Makefile for coreboot paper.
|
|
# hacked together by Stefan Reinauer <stepan@openbios.org>
|
|
#
|
|
|
|
BUILDDIR ?= _build
|
|
SPHINXOPTS ?= -j auto
|
|
|
|
export SPHINXOPTS
|
|
|
|
all: sphinx
|
|
|
|
$(BUILDDIR):
|
|
mkdir -p $(BUILDDIR)
|
|
|
|
sphinx: $(BUILDDIR)
|
|
$(MAKE) -f Makefile.sphinx html BUILDDIR="$(BUILDDIR)"
|
|
|
|
clean-sphinx:
|
|
$(MAKE) -f Makefile.sphinx clean BUILDDIR="$(BUILDDIR)"
|
|
|
|
clean: clean-sphinx
|
|
rm -f *.aux *.idx *.log *.toc *.out $(FIGS)
|
|
|
|
distclean: clean
|
|
rm -f corebootPortingGuide.pdf
|
|
|
|
livesphinx: $(BUILDDIR)
|
|
$(MAKE) -f Makefile.sphinx livehtml BUILDDIR="$(BUILDDIR)"
|
|
|
|
test:
|
|
@echo "Test for logging purposes - Failing tests will not fail the build"
|
|
-$(MAKE) -f Makefile.sphinx clean && $(MAKE) -k -f Makefile.sphinx html
|
|
|
|
help:
|
|
@echo "all - Builds all documentation targets"
|
|
@echo "sphinx - Builds html documentation in _build directory"
|
|
@echo "clean - Cleans intermediate files"
|
|
@echo "clean-sphinx - Removes sphinx output files"
|
|
@echo "distclean - Removes PDF files as well"
|
|
@echo "test - Runs documentation tests"
|
|
@echo
|
|
@echo " Makefile.sphinx builds - run with $(MAKE) -f Makefile-sphinx [target]"
|
|
@echo
|
|
@$(MAKE) -s -f Makefile.sphinx help 2>/dev/null
|
|
|
|
.phony: help livesphinx sphinx test
|
|
.phony: distclean clean clean-sphinx
|