doc-rst: linux_tv/Makefile: Honor quiet mode

Cleanup the Makefile and handle the V=1 flag and make it
to work when specifying an output directory with O=dir

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
This commit is contained in:
Mauro Carvalho Chehab 2016-07-07 09:29:48 -03:00
parent 249e5ba0be
commit 573720f07b
2 changed files with 33 additions and 18 deletions

View File

@ -35,7 +35,7 @@ quiet_cmd_sphinx = SPHINX $@
cmd_sphinx = $(SPHINXBUILD) -b $2 $(ALLSPHINXOPTS) $(BUILDDIR)/$2 cmd_sphinx = $(SPHINXBUILD) -b $2 $(ALLSPHINXOPTS) $(BUILDDIR)/$2
htmldocs: htmldocs:
$(MAKE) -C $(srctree)/Documentation/linux_tv $@ $(MAKE) BUILDDIR=$(objtree)/$(BUILDDIR) -f $(srctree)/Documentation/linux_tv/Makefile $@
$(call cmd,sphinx,html) $(call cmd,sphinx,html)
pdfdocs: pdfdocs:

View File

@ -1,32 +1,47 @@
# Generate the *.h.rst files from uAPI headers # Generate the *.h.rst files from uAPI headers
PARSER = ../sphinx/parse-headers.pl PARSER = $(srctree)/Documentation/sphinx/parse-headers.pl
UAPI = ../../include/uapi/linux UAPI = $(srctree)/include/uapi/linux
TARGETS = audio.h.rst ca.h.rst dmx.h.rst frontend.h.rst net.h.rst video.h.rst \ SRC_DIR=$(srctree)/Documentation/linux_tv
FILES = audio.h.rst ca.h.rst dmx.h.rst frontend.h.rst net.h.rst video.h.rst \
videodev2.h.rst videodev2.h.rst
TARGETS := $(addprefix $(BUILDDIR)/, $(FILES))
htmldocs: ${TARGETS} htmldocs: ${TARGETS}
audio.h.rst: ${PARSER} ${UAPI}/dvb/audio.h audio.h.rst.exceptions # Rule to convert a .h file to inline RST documentation
${PARSER} ${UAPI}/dvb/audio.h $@ audio.h.rst.exceptions
ca.h.rst: ${PARSER} ${UAPI}/dvb/ca.h ca.h.rst.exceptions gen_rst = \
${PARSER} ${UAPI}/dvb/ca.h $@ ca.h.rst.exceptions echo ${PARSER} $< $@ $(SRC_DIR)/$(notdir $@).exceptions; \
${PARSER} $< $@ $(SRC_DIR)/$(notdir $@).exceptions
dmx.h.rst: ${PARSER} ${UAPI}/dvb/dmx.h dmx.h.rst.exceptions quiet_gen_rst = echo ' PARSE $(patsubst $(srctree)/%,%,$<)'; \
${PARSER} ${UAPI}/dvb/dmx.h $@ dmx.h.rst.exceptions ${PARSER} $< $@ $(SRC_DIR)/$(notdir $@).exceptions
frontend.h.rst: ${PARSER} ${UAPI}/dvb/frontend.h frontend.h.rst.exceptions silent_gen_rst = ${gen_rst}
${PARSER} ${UAPI}/dvb/frontend.h $@ frontend.h.rst.exceptions
net.h.rst: ${PARSER} ${UAPI}/dvb/net.h net.h.rst.exceptions $(BUILDDIR)/audio.h.rst: ${UAPI}/dvb/audio.h ${PARSER} $(SRC_DIR)/audio.h.rst.exceptions
${PARSER} ${UAPI}/dvb/net.h $@ net.h.rst.exceptions @$($(quiet)gen_rst)
video.h.rst: ${PARSER} ${UAPI}/dvb/video.h video.h.rst.exceptions $(BUILDDIR)/ca.h.rst: ${UAPI}/dvb/ca.h ${PARSER} $(SRC_DIR)/ca.h.rst.exceptions
${PARSER} ${UAPI}/dvb/video.h $@ video.h.rst.exceptions @$($(quiet)gen_rst)
videodev2.h.rst: ${UAPI}/videodev2.h ${PARSER} videodev2.h.rst.exceptions $(BUILDDIR)/dmx.h.rst: ${UAPI}/dvb/dmx.h ${PARSER} $(SRC_DIR)/dmx.h.rst.exceptions
${PARSER} ${UAPI}/videodev2.h $@ videodev2.h.rst.exceptions @$($(quiet)gen_rst)
$(BUILDDIR)/frontend.h.rst: ${UAPI}/dvb/frontend.h ${PARSER} $(SRC_DIR)/frontend.h.rst.exceptions
@$($(quiet)gen_rst)
$(BUILDDIR)/net.h.rst: ${UAPI}/dvb/net.h ${PARSER} $(SRC_DIR)/net.h.rst.exceptions
@$($(quiet)gen_rst)
$(BUILDDIR)/video.h.rst: ${UAPI}/dvb/video.h ${PARSER} $(SRC_DIR)/video.h.rst.exceptions
@$($(quiet)gen_rst)
videodev2.h.rst: ${UAPI}/videodev2.h ${PARSER} $(SRC_DIR)/videodev2.h.rst.exceptions
@$($(quiet)gen_rst)
cleandocs: cleandocs:
-rm ${TARGETS} -rm ${TARGETS}