1# SPDX-License-Identifier: GPL-2.0 2 3# Rules to convert a .h file to inline RST documentation 4 5SRC_DIR=$(srctree)/Documentation/userspace-api/media 6PARSER = $(srctree)/Documentation/sphinx/parse-headers.pl 7UAPI = $(srctree)/include/uapi/linux 8KAPI = $(srctree)/include/linux 9 10FILES = 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 13TARGETS := $(addprefix $(BUILDDIR)/, $(FILES)) 14 15gen_rst = \ 16 echo ${PARSER} $< $@ $(SRC_DIR)/$(notdir $@).exceptions; \ 17 ${PARSER} $< $@ $(SRC_DIR)/$(notdir $@).exceptions 18 19quiet_gen_rst = echo ' PARSE $(patsubst $(srctree)/%,%,$<)'; \ 20 ${PARSER} $< $@ $(SRC_DIR)/$(notdir $@).exceptions 21 22silent_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 epub xml latex 51 52all: $(IMGDOT) $(BUILDDIR) ${TARGETS} 53html: all 54epub: all 55xml: all 56latex: $(IMGPDF) all 57linkcheck: 58 59clean: 60 -rm -f $(DOTTGT) $(IMGTGT) ${TARGETS} 2>/dev/null 61 62$(BUILDDIR): 63 $(Q)mkdir -p $@ 64