docs-rst: media/Makefile: reorganize the rules

Better organize the media/Makefile, in order to better
split what's related to image conversion from the ones
related to parse-headers.pl.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
This commit is contained in:
Mauro Carvalho Chehab 2016-11-30 08:00:18 -02:00 committed by Jonathan Corbet
parent ec868e4ee2
commit bf5bfe85ec
1 changed files with 24 additions and 21 deletions

View File

@ -1,15 +1,7 @@
# Generate the *.h.rst files from uAPI headers # Rules to convert DOT and SVG to Sphinx images
PARSER = $(srctree)/Documentation/sphinx/parse-headers.pl
UAPI = $(srctree)/include/uapi/linux
KAPI = $(srctree)/include/linux
SRC_DIR=$(srctree)/Documentation/media SRC_DIR=$(srctree)/Documentation/media
FILES = audio.h.rst ca.h.rst dmx.h.rst frontend.h.rst net.h.rst video.h.rst \
videodev2.h.rst media.h.rst cec.h.rst lirc.h.rst
TARGETS := $(addprefix $(BUILDDIR)/, $(FILES))
DOTS = \ DOTS = \
uapi/v4l/pipeline.dot \ uapi/v4l/pipeline.dot \
@ -52,21 +44,16 @@ quiet_cmd_gendot = DOT $2
%.svg: %.dot %.svg: %.dot
@$(call cmd,gendot,$<,$@) @$(call cmd,gendot,$<,$@)
.PHONY: all html epub xml latex # Rules to convert a .h file to inline RST documentation
all: $(IMGDOT) $(BUILDDIR) ${TARGETS} PARSER = $(srctree)/Documentation/sphinx/parse-headers.pl
html: all UAPI = $(srctree)/include/uapi/linux
epub: all KAPI = $(srctree)/include/linux
xml: all
latex: $(IMGPDF) all
clean: FILES = audio.h.rst ca.h.rst dmx.h.rst frontend.h.rst net.h.rst video.h.rst \
-rm -f $(DOTTGT) $(IMGTGT) $(patsubst %,$(SRC_DIR)/%,${TARGETS}) 2>/dev/null videodev2.h.rst media.h.rst cec.h.rst lirc.h.rst
$(BUILDDIR): TARGETS := $(addprefix $(BUILDDIR)/, $(FILES))
$(Q)mkdir -p $@
# Rule to convert a .h file to inline RST documentation
gen_rst = \ gen_rst = \
echo ${PARSER} $< $@ $(SRC_DIR)/$(notdir $@).exceptions; \ echo ${PARSER} $< $@ $(SRC_DIR)/$(notdir $@).exceptions; \
@ -106,3 +93,19 @@ $(BUILDDIR)/cec.h.rst: ${KAPI}/cec.h ${PARSER} $(SRC_DIR)/cec.h.rst.exceptions
$(BUILDDIR)/lirc.h.rst: ${UAPI}/lirc.h ${PARSER} $(SRC_DIR)/lirc.h.rst.exceptions $(BUILDDIR)/lirc.h.rst: ${UAPI}/lirc.h ${PARSER} $(SRC_DIR)/lirc.h.rst.exceptions
@$($(quiet)gen_rst) @$($(quiet)gen_rst)
# Media build rules
.PHONY: all html epub xml latex
all: $(IMGDOT) $(BUILDDIR) ${TARGETS}
html: all
epub: all
xml: all
latex: $(IMGPDF) all
clean:
-rm -f $(DOTTGT) $(IMGTGT) $(patsubst %,$(SRC_DIR)/%,${TARGETS}) 2>/dev/null
$(BUILDDIR):
$(Q)mkdir -p $@