1 # SPDX-License-Identifier: GPL-2.0
3 # Rules to convert a .h file to inline RST documentation
5 SRC_DIR
=$(srctree
)/Documentation
/media
6 PARSER
= $(srctree
)/Documentation
/sphinx
/parse-headers.pl
7 UAPI
= $(srctree
)/include/uapi
/linux
8 KAPI
= $(srctree
)/include/linux
10 FILES
= audio.h.rst ca.h.rst dmx.h.rst frontend.h.rst net.h.rst video.h.rst \
11 videodev2.h.rst media.h.rst cec.h.rst lirc.h.rst
13 TARGETS
:= $(addprefix $(BUILDDIR
)/, $(FILES
))
16 echo
${PARSER} $< $@
$(SRC_DIR
)/$(notdir $@
).exceptions
; \
17 ${PARSER} $< $@
$(SRC_DIR
)/$(notdir $@
).exceptions
19 quiet_gen_rst
= echo
' PARSE $(patsubst $(srctree)/%,%,$<)'; \
20 ${PARSER} $< $@
$(SRC_DIR
)/$(notdir $@
).exceptions
22 silent_gen_rst
= ${gen_rst}
24 $(BUILDDIR
)/audio.h.rst
: ${UAPI}/dvb
/audio.h
${PARSER} $(SRC_DIR
)/audio.h.rst.exceptions
27 $(BUILDDIR
)/ca.h.rst
: ${UAPI}/dvb
/ca.h
${PARSER} $(SRC_DIR
)/ca.h.rst.exceptions
30 $(BUILDDIR
)/dmx.h.rst
: ${UAPI}/dvb
/dmx.h
${PARSER} $(SRC_DIR
)/dmx.h.rst.exceptions
33 $(BUILDDIR
)/frontend.h.rst
: ${UAPI}/dvb
/frontend.h
${PARSER} $(SRC_DIR
)/frontend.h.rst.exceptions
36 $(BUILDDIR
)/net.h.rst
: ${UAPI}/dvb
/net.h
${PARSER} $(SRC_DIR
)/net.h.rst.exceptions
39 $(BUILDDIR
)/video.h.rst
: ${UAPI}/dvb
/video.h
${PARSER} $(SRC_DIR
)/video.h.rst.exceptions
42 $(BUILDDIR
)/videodev2.h.rst
: ${UAPI}/videodev2.h
${PARSER} $(SRC_DIR
)/videodev2.h.rst.exceptions
45 $(BUILDDIR
)/media.h.rst
: ${UAPI}/media.h
${PARSER} $(SRC_DIR
)/media.h.rst.exceptions
48 $(BUILDDIR
)/cec.h.rst
: ${UAPI}/cec.h
${PARSER} $(SRC_DIR
)/cec.h.rst.exceptions
51 $(BUILDDIR
)/lirc.h.rst
: ${UAPI}/lirc.h
${PARSER} $(SRC_DIR
)/lirc.h.rst.exceptions
56 .PHONY
: all html epub xml latex
58 all: $(IMGDOT
) $(BUILDDIR
) ${TARGETS}
66 -rm -f
$(DOTTGT
) $(IMGTGT
) ${TARGETS} 2>/dev
/null
