| rjw | 1f88458 | 2022-01-06 17:20:42 +0800 | [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 | UAPI = $(srctree)/include/uapi/linux |
| 6 | KAPI = $(srctree)/include/linux |
| 7 | |
| 8 | FILES = audio.h.rst ca.h.rst dmx.h.rst frontend.h.rst net.h.rst video.h.rst \ |
| 9 | videodev2.h.rst media.h.rst cec.h.rst lirc.h.rst |
| 10 | |
| 11 | TARGETS := $(addprefix $(BUILDDIR)/, $(FILES)) |
| 12 | |
| 13 | gen_rst = \ |
| 14 | echo ${PARSER} $< $@ $(SRC_DIR)/$(notdir $@).exceptions; \ |
| 15 | ${PARSER} $< $@ $(SRC_DIR)/$(notdir $@).exceptions |
| 16 | |
| 17 | quiet_gen_rst = echo ' PARSE $(patsubst $(srctree)/%,%,$<)'; \ |
| 18 | ${PARSER} $< $@ $(SRC_DIR)/$(notdir $@).exceptions |
| 19 | |
| 20 | silent_gen_rst = ${gen_rst} |
| 21 | |
| 22 | $(BUILDDIR)/audio.h.rst: ${UAPI}/dvb/audio.h ${PARSER} $(SRC_DIR)/audio.h.rst.exceptions |
| 23 | @$($(quiet)gen_rst) |
| 24 | |
| 25 | $(BUILDDIR)/ca.h.rst: ${UAPI}/dvb/ca.h ${PARSER} $(SRC_DIR)/ca.h.rst.exceptions |
| 26 | @$($(quiet)gen_rst) |
| 27 | |
| 28 | $(BUILDDIR)/dmx.h.rst: ${UAPI}/dvb/dmx.h ${PARSER} $(SRC_DIR)/dmx.h.rst.exceptions |
| 29 | @$($(quiet)gen_rst) |
| 30 | |
| 31 | $(BUILDDIR)/frontend.h.rst: ${UAPI}/dvb/frontend.h ${PARSER} $(SRC_DIR)/frontend.h.rst.exceptions |
| 32 | @$($(quiet)gen_rst) |
| 33 | |
| 34 | $(BUILDDIR)/net.h.rst: ${UAPI}/dvb/net.h ${PARSER} $(SRC_DIR)/net.h.rst.exceptions |
| 35 | @$($(quiet)gen_rst) |
| 36 | |
| 37 | $(BUILDDIR)/video.h.rst: ${UAPI}/dvb/video.h ${PARSER} $(SRC_DIR)/video.h.rst.exceptions |
| 38 | @$($(quiet)gen_rst) |
| 39 | |
| 40 | $(BUILDDIR)/videodev2.h.rst: ${UAPI}/videodev2.h ${PARSER} $(SRC_DIR)/videodev2.h.rst.exceptions |
| 41 | @$($(quiet)gen_rst) |
| 42 | |
| 43 | $(BUILDDIR)/media.h.rst: ${UAPI}/media.h ${PARSER} $(SRC_DIR)/media.h.rst.exceptions |
| 44 | @$($(quiet)gen_rst) |
| 45 | |
| 46 | $(BUILDDIR)/cec.h.rst: ${UAPI}/cec.h ${PARSER} $(SRC_DIR)/cec.h.rst.exceptions |
| 47 | @$($(quiet)gen_rst) |
| 48 | |
| 49 | $(BUILDDIR)/lirc.h.rst: ${UAPI}/lirc.h ${PARSER} $(SRC_DIR)/lirc.h.rst.exceptions |
| 50 | @$($(quiet)gen_rst) |
| 51 | |
| 52 | # Media build rules |
| 53 | |
| 54 | .PHONY: all html epub xml latex |
| 55 | |
| 56 | all: $(IMGDOT) $(BUILDDIR) ${TARGETS} |
| 57 | html: all |
| 58 | epub: all |
| 59 | xml: all |
| 60 | latex: $(IMGPDF) all |
| 61 | linkcheck: |
| 62 | |
| 63 | clean: |
| 64 | -rm -f $(DOTTGT) $(IMGTGT) ${TARGETS} 2>/dev/null |
| 65 | |
| 66 | $(BUILDDIR): |
| 67 | $(Q)mkdir -p $@ |