2018-07-10 06:40:17 +00:00
|
|
|
# Rules to convert a .h file to inline RST documentation
|
|
|
|
|
2019-06-05 18:18:30 +00:00
|
|
|
SRC_DIR=$(srctree)/doc/media
|
|
|
|
PARSER = $(srctree)/doc/sphinx/parse-headers.pl
|
2018-07-10 06:40:17 +00:00
|
|
|
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 = echo ' PARSE $(patsubst $(srctree)/%,%,$<)'; \
|
|
|
|
${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 epub xml latex
|
|
|
|
|
|
|
|
all: $(IMGDOT) $(BUILDDIR) ${TARGETS}
|
|
|
|
html: all
|
|
|
|
epub: all
|
|
|
|
xml: all
|
|
|
|
latex: $(IMGPDF) all
|
|
|
|
linkcheck:
|
|
|
|
|
|
|
|
clean:
|
|
|
|
-rm -f $(DOTTGT) $(IMGTGT) ${TARGETS} 2>/dev/null
|
|
|
|
|
|
|
|
$(BUILDDIR):
|
|
|
|
$(Q)mkdir -p $@
|