Mario Six | 8fac291 | 2018-07-10 08:40:17 +0200 | [diff] [blame] | 1 | # Rules to convert a .h file to inline RST documentation |
| 2 | |
| 3 | SRC_DIR=$(srctree)/Documentation/media |
| 4 | PARSER = $(srctree)/Documentation/sphinx/parse-headers.pl |
| 5 | API = $(srctree)/include |
| 6 | |
| 7 | FILES = linker_lists.h.rst |
| 8 | |
| 9 | TARGETS := $(addprefix $(BUILDDIR)/, $(FILES)) |
| 10 | |
| 11 | gen_rst = \ |
| 12 | echo ${PARSER} $< $@ $(SRC_DIR)/$(notdir $@).exceptions; \ |
| 13 | ${PARSER} $< $@ $(SRC_DIR)/$(notdir $@).exceptions |
| 14 | |
| 15 | quiet_gen_rst = echo ' PARSE $(patsubst $(srctree)/%,%,$<)'; \ |
| 16 | ${PARSER} $< $@ $(SRC_DIR)/$(notdir $@).exceptions |
| 17 | |
| 18 | silent_gen_rst = ${gen_rst} |
| 19 | |
| 20 | $(BUILDDIR)/linker_lists.h.rst: ${API}/linker_lists.h ${PARSER} $(SRC_DIR)/linker_lists.h.rst.exceptions |
| 21 | @$($(quiet)gen_rst) |
| 22 | |
| 23 | # Media build rules |
| 24 | |
| 25 | .PHONY: all html epub xml latex |
| 26 | |
| 27 | all: $(IMGDOT) $(BUILDDIR) ${TARGETS} |
| 28 | html: all |
| 29 | epub: all |
| 30 | xml: all |
| 31 | latex: $(IMGPDF) all |
| 32 | linkcheck: |
| 33 | |
| 34 | clean: |
| 35 | -rm -f $(DOTTGT) $(IMGTGT) ${TARGETS} 2>/dev/null |
| 36 | |
| 37 | $(BUILDDIR): |
| 38 | $(Q)mkdir -p $@ |