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:
parent
ec868e4ee2
commit
bf5bfe85ec
|
@ -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 $@
|
||||||
|
|
Loading…
Reference in New Issue