Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
tjh.dev
kernel
os
linux
1# Generate the *.h.rst files from uAPI headers
2
3PARSER = $(srctree)/Documentation/sphinx/parse-headers.pl
4UAPI = $(srctree)/include/uapi/linux
5KAPI = $(srctree)/include/linux
6SRC_DIR=$(srctree)/Documentation/media
7
8FILES = 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
11TARGETS := $(addprefix $(BUILDDIR)/, $(FILES))
12
13htmldocs: $(BUILDDIR) ${TARGETS}
14
15$(BUILDDIR):
16 $(Q)mkdir -p $@
17
18# Rule to convert a .h file to inline RST documentation
19
20gen_rst = \
21 echo ${PARSER} $< $@ $(SRC_DIR)/$(notdir $@).exceptions; \
22 ${PARSER} $< $@ $(SRC_DIR)/$(notdir $@).exceptions
23
24quiet_gen_rst = echo ' PARSE $(patsubst $(srctree)/%,%,$<)'; \
25 ${PARSER} $< $@ $(SRC_DIR)/$(notdir $@).exceptions
26
27silent_gen_rst = ${gen_rst}
28
29$(BUILDDIR)/audio.h.rst: ${UAPI}/dvb/audio.h ${PARSER} $(SRC_DIR)/audio.h.rst.exceptions
30 @$($(quiet)gen_rst)
31
32$(BUILDDIR)/ca.h.rst: ${UAPI}/dvb/ca.h ${PARSER} $(SRC_DIR)/ca.h.rst.exceptions
33 @$($(quiet)gen_rst)
34
35$(BUILDDIR)/dmx.h.rst: ${UAPI}/dvb/dmx.h ${PARSER} $(SRC_DIR)/dmx.h.rst.exceptions
36 @$($(quiet)gen_rst)
37
38$(BUILDDIR)/frontend.h.rst: ${UAPI}/dvb/frontend.h ${PARSER} $(SRC_DIR)/frontend.h.rst.exceptions
39 @$($(quiet)gen_rst)
40
41$(BUILDDIR)/net.h.rst: ${UAPI}/dvb/net.h ${PARSER} $(SRC_DIR)/net.h.rst.exceptions
42 @$($(quiet)gen_rst)
43
44$(BUILDDIR)/video.h.rst: ${UAPI}/dvb/video.h ${PARSER} $(SRC_DIR)/video.h.rst.exceptions
45 @$($(quiet)gen_rst)
46
47$(BUILDDIR)/videodev2.h.rst: ${UAPI}/videodev2.h ${PARSER} $(SRC_DIR)/videodev2.h.rst.exceptions
48 @$($(quiet)gen_rst)
49
50$(BUILDDIR)/media.h.rst: ${UAPI}/media.h ${PARSER} $(SRC_DIR)/media.h.rst.exceptions
51 @$($(quiet)gen_rst)
52
53$(BUILDDIR)/cec.h.rst: ${KAPI}/cec.h ${PARSER} $(SRC_DIR)/cec.h.rst.exceptions
54 @$($(quiet)gen_rst)
55
56$(BUILDDIR)/lirc.h.rst: ${UAPI}/lirc.h ${PARSER} $(SRC_DIR)/lirc.h.rst.exceptions
57 @$($(quiet)gen_rst)
58
59cleandocs:
60 -rm ${TARGETS}