1 # SPDX-License-Identifier: GPL-2.0 2 3 # Rules to convert a .h file to inline RST documentation 4 5 SRC_DIR=$(srctree)/Documentation/userspace-api/media 6 PARSER = $(srctree)/Documentation/sphinx/parse-headers.pl 7 UAPI = $(srctree)/include/uapi/linux 8 KAPI = $(srctree)/include/linux 9 10 FILES = ca.h.rst dmx.h.rst frontend.h.rst net.h.rst \ 11 videodev2.h.rst media.h.rst cec.h.rst lirc.h.rst 12 13 TARGETS := $(addprefix $(BUILDDIR)/, $(FILES)) 14 15 gen_rst = \ 16 echo ${PARSER} $< $@ $(SRC_DIR)/$(notdir $@).exceptions; \ 17 ${PARSER} $< $@ $(SRC_DIR)/$(notdir $@).exceptions 18 19 quiet_gen_rst = echo ' PARSE $(patsubst $(srctree)/%,%,$<)'; \ 20 ${PARSER} $< $@ $(SRC_DIR)/$(notdir $@).exceptions 21 22 silent_gen_rst = ${gen_rst} 23 24 $(BUILDDIR)/ca.h.rst: ${UAPI}/dvb/ca.h ${PARSER} $(SRC_DIR)/ca.h.rst.exceptions 25 @$($(quiet)gen_rst) 26 27 $(BUILDDIR)/dmx.h.rst: ${UAPI}/dvb/dmx.h ${PARSER} $(SRC_DIR)/dmx.h.rst.exceptions 28 @$($(quiet)gen_rst) 29 30 $(BUILDDIR)/frontend.h.rst: ${UAPI}/dvb/frontend.h ${PARSER} $(SRC_DIR)/frontend.h.rst.exceptions 31 @$($(quiet)gen_rst) 32 33 $(BUILDDIR)/net.h.rst: ${UAPI}/dvb/net.h ${PARSER} $(SRC_DIR)/net.h.rst.exceptions 34 @$($(quiet)gen_rst) 35 36 $(BUILDDIR)/videodev2.h.rst: ${UAPI}/videodev2.h ${PARSER} $(SRC_DIR)/videodev2.h.rst.exceptions 37 @$($(quiet)gen_rst) 38 39 $(BUILDDIR)/media.h.rst: ${UAPI}/media.h ${PARSER} $(SRC_DIR)/media.h.rst.exceptions 40 @$($(quiet)gen_rst) 41 42 $(BUILDDIR)/cec.h.rst: ${UAPI}/cec.h ${PARSER} $(SRC_DIR)/cec.h.rst.exceptions 43 @$($(quiet)gen_rst) 44 45 $(BUILDDIR)/lirc.h.rst: ${UAPI}/lirc.h ${PARSER} $(SRC_DIR)/lirc.h.rst.exceptions 46 @$($(quiet)gen_rst) 47 48 # Media build rules 49 50 .PHONY: all html texinfo epub xml latex 51 52 all: $(IMGDOT) $(BUILDDIR) ${TARGETS} 53 html: all 54 texinfo: all 55 epub: all 56 xml: all 57 latex: $(IMGPDF) all 58 linkcheck: 59 60 clean: 61 -rm -f $(DOTTGT) $(IMGTGT) ${TARGETS} 2>/dev/null 62 63 $(BUILDDIR): 64 $(Q)mkdir -p $@ 65