4bb6fac020
This message is not needed since sphinx is now running in quiet mode. Series-to: concept Series-cc: heinrich Cover-letter: doc: Silence the sphinx build output The sphinx/htmldocs build is very noisy, making it hard to see warnings and errors. This series enables quiet mode for sphinx and removes various other progress messages, so that only warnings and errors are shown. END Co-developed-by: Claude Opus 4.5 <noreply@anthropic.com> Signed-off-by: Simon Glass <simon.glass@canonical.com> Series-links: 1:93
39 lines
850 B
Makefile
39 lines
850 B
Makefile
# Rules to convert a .h file to inline RST documentation
|
|
|
|
SRC_DIR=$(srctree)/doc/media
|
|
PARSER = $(srctree)/doc/sphinx/parse-headers.pl
|
|
API = $(srctree)/include
|
|
|
|
FILES = linker_lists.h.rst
|
|
|
|
TARGETS := $(addprefix $(BUILDDIR)/, $(FILES))
|
|
|
|
gen_rst = \
|
|
echo ${PARSER} $< $@ $(SRC_DIR)/$(notdir $@).exceptions; \
|
|
${PARSER} $< $@ $(SRC_DIR)/$(notdir $@).exceptions
|
|
|
|
quiet_gen_rst = ${PARSER} $< $@ $(SRC_DIR)/$(notdir $@).exceptions
|
|
|
|
silent_gen_rst = ${gen_rst}
|
|
|
|
$(BUILDDIR)/linker_lists.h.rst: ${API}/linker_lists.h ${PARSER} $(SRC_DIR)/linker_lists.h.rst.exceptions
|
|
@$($(quiet)gen_rst)
|
|
|
|
# Media build rules
|
|
|
|
.PHONY: all html texinfo epub xml latex
|
|
|
|
all: $(IMGDOT) $(BUILDDIR) ${TARGETS}
|
|
html: all
|
|
texinfo: all
|
|
epub: all
|
|
xml: all
|
|
latex: $(IMGPDF) all
|
|
linkcheck:
|
|
|
|
clean:
|
|
-rm -f $(DOTTGT) $(IMGTGT) ${TARGETS} 2>/dev/null
|
|
|
|
$(BUILDDIR):
|
|
$(Q)mkdir -p $@
|