ffmpeg/doc/Makefile

MANPAGES    = $(PROGS-yes:%=doc/%.1)
PODPAGES    = $(PROGS-yes:%=doc/%.pod)
HTMLPAGES   = $(PROGS-yes:%=doc/%.html)                                 \
              doc/developer.html                                        \
              doc/faq.html                                              \
              doc/fate.html                                             \
              doc/general.html                                          \
              doc/git-howto.html                                        \
              doc/platform.html                                         \
              doc/syntax.html                                           \

TXTPAGES    = doc/fate.txt                                              \


DOCS-$(CONFIG_HTMLPAGES) += $(HTMLPAGES)
DOCS-$(CONFIG_PODPAGES)  += $(PODPAGES)
DOCS-$(CONFIG_MANPAGES)  += $(MANPAGES)
DOCS-$(CONFIG_TXTPAGES)  += $(TXTPAGES)
DOCS = $(DOCS-yes)

all-$(CONFIG_DOC): doc

doc: documentation

documentation: $(DOCS)

TEXIDEP = awk '/^@(verbatim)?include/ { printf "$@: $(@D)/%s\n", $$2 }' <$< >$(@:%=%.d)

doc/%.txt: TAG = TXT
doc/%.txt: doc/%.texi
	$(Q)$(TEXIDEP)
	$(M)makeinfo --force --no-headers -o $@ $< 2>/dev/null

GENTEXI  = format codec
GENTEXI := $(GENTEXI:%=doc/avoptions_%.texi)

$(GENTEXI): TAG = GENTEXI
$(GENTEXI): doc/avoptions_%.texi: doc/print_options$(HOSTEXESUF)
	$(M)doc/print_options $* > $@

doc/%.html: TAG = HTML
doc/%.html: doc/%.texi $(SRC_PATH)/doc/t2h.init $(GENTEXI)
	$(Q)$(TEXIDEP)
	$(M)texi2html -I doc -monolithic --init-file $(SRC_PATH)/doc/t2h.init --output $@ $<

doc/%.pod: TAG = POD
doc/%.pod: doc/%.texi $(GENTEXI)
	$(Q)$(TEXIDEP)
	$(M)perl $(SRC_PATH)/doc/texi2pod.pl -Idoc $< $@

doc/%.1: TAG = MAN
doc/%.1: doc/%.pod $(GENTEXI)
	$(M)pod2man --section=1 --center=" " --release=" " $< > $@

$(DOCS): | doc/

install-man:

ifdef CONFIG_MANPAGES
install-progs-$(CONFIG_DOC): install-man

install-man: $(MANPAGES)
	$(Q)mkdir -p "$(MANDIR)/man1"
	$(INSTALL) -m 644 $(MANPAGES) "$(MANDIR)/man1"
endif

uninstall: uninstall-man

uninstall-man:
	$(RM) $(addprefix "$(MANDIR)/man1/",$(ALLMANPAGES))

clean::
	$(RM) $(TXTPAGES) doc/*.html doc/*.pod doc/*.1 $(CLEANSUFFIXES:%=doc/%) doc/avoptions_*.texi

-include $(wildcard $(DOCS:%=%.d))

.PHONY: doc documentation
build: move documentation rules to doc/Makefile Signed-off-by: Mans Rullgard <mans@mansr.com> 2011-06-06 19:03:22 +02:00			`MANPAGES = $(PROGS-yes:%=doc/%.1)`
			`PODPAGES = $(PROGS-yes:%=doc/%.pod)`
build: merge lists of HTML documentation targets 2011-12-07 21:49:53 +01:00			`HTMLPAGES = $(PROGS-yes:%=doc/%.html) \`
			`doc/developer.html \`
			`doc/faq.html \`
doc: document fate in a texinfo Summarize the information provided in the wiki and the one provided in fate.txt 2011-12-02 01:33:07 +01:00			`doc/fate.html \`
build: merge lists of HTML documentation targets 2011-12-07 21:49:53 +01:00			`doc/general.html \`
doc: port the git-howto to texinfo 2011-12-03 18:06:14 +01:00			`doc/git-howto.html \`
doc: split platform specific information Move the platform-specific information in its own file. 2011-12-03 21:25:04 +01:00			`doc/platform.html \`
doc: add syntax.texi file 2012-05-03 15:14:14 +02:00			`doc/syntax.html \`
build: move documentation rules to doc/Makefile Signed-off-by: Mans Rullgard <mans@mansr.com> 2011-06-06 19:03:22 +02:00
doc: fate: Support building a plain text version Also create a plain text (.txt) file from fate.texi if the makeinfo program is available. Signed-off-by: Alexander Strasser <eclipse7@gmx.net> Signed-off-by: Michael Niedermayer <michaelni@gmx.at> 2011-12-20 00:28:47 +01:00			`TXTPAGES = doc/fate.txt \`


build: extend documentation building mechanism Allow to select specific documentation components, and reliably check for component dependencies. In particular, check for perl presence on the system. 2012-08-09 23:37:28 +02:00			`DOCS-$(CONFIG_HTMLPAGES) += $(HTMLPAGES)`
			`DOCS-$(CONFIG_PODPAGES) += $(PODPAGES)`
			`DOCS-$(CONFIG_MANPAGES) += $(MANPAGES)`
			`DOCS-$(CONFIG_TXTPAGES) += $(TXTPAGES)`
build: Fix documentation dependencies and rules 2012-07-12 03:41:25 +02:00			`DOCS = $(DOCS-yes)`
build: move documentation rules to doc/Makefile Signed-off-by: Mans Rullgard <mans@mansr.com> 2011-06-06 19:03:22 +02:00
doc/Makefile: add doc target, as an alias for "documentation" Consistent with --enable-doc, and easier to type. 2012-08-11 11:58:57 +02:00			`all-$(CONFIG_DOC): doc`

			`doc: documentation`
build: move documentation rules to doc/Makefile Signed-off-by: Mans Rullgard <mans@mansr.com> 2011-06-06 19:03:22 +02:00
			`documentation: $(DOCS)`

doc: build: TEXIDEP: Recognize verbatim includes When generating the .dep files for .texi sources, verbatim includes (@verbatiminclude) should also be taken into account. Signed-off-by: Alexander Strasser <eclipse7@gmx.net> Signed-off-by: Michael Niedermayer <michaelni@gmx.at> 2011-12-20 00:27:22 +01:00			`TEXIDEP = awk '/^@(verbatim)?include/ { printf "$@: $(@D)/%s\n", $$2 }' <$< >$(@:%=%.d)`
build: move documentation rules to doc/Makefile Signed-off-by: Mans Rullgard <mans@mansr.com> 2011-06-06 19:03:22 +02:00
doc: fate: Support building a plain text version Also create a plain text (.txt) file from fate.texi if the makeinfo program is available. Signed-off-by: Alexander Strasser <eclipse7@gmx.net> Signed-off-by: Michael Niedermayer <michaelni@gmx.at> 2011-12-20 00:28:47 +01:00			`doc/%.txt: TAG = TXT`
			`doc/%.txt: doc/%.texi`
			`$(Q)$(TEXIDEP)`
			`$(M)makeinfo --force --no-headers -o $@ $< 2>/dev/null`

Generate manpages for AV{Format,Codec}Context AVOptions. 2012-03-14 20:08:50 +01:00			`GENTEXI = format codec`
			`GENTEXI := $(GENTEXI:%=doc/avoptions_%.texi)`

			`$(GENTEXI): TAG = GENTEXI`
doc/Makefile: Add missing $(HOSTEXESUF) to print_options 2012-07-12 03:45:00 +02:00			`$(GENTEXI): doc/avoptions_%.texi: doc/print_options$(HOSTEXESUF)`
Generate manpages for AV{Format,Codec}Context AVOptions. 2012-03-14 20:08:50 +01:00			`$(M)doc/print_options $* > $@`

build: move documentation rules to doc/Makefile Signed-off-by: Mans Rullgard <mans@mansr.com> 2011-06-06 19:03:22 +02:00			`doc/%.html: TAG = HTML`
Generate manpages for AV{Format,Codec}Context AVOptions. 2012-03-14 20:08:50 +01:00			`doc/%.html: doc/%.texi $(SRC_PATH)/doc/t2h.init $(GENTEXI)`
build: move documentation rules to doc/Makefile Signed-off-by: Mans Rullgard <mans@mansr.com> 2011-06-06 19:03:22 +02:00			`$(Q)$(TEXIDEP)`
doc: pass -Idoc texi2html and texi2pod This fixes doc generation in build tree separate from source. Signed-off-by: Mans Rullgard <mans@mansr.com> 2012-03-20 11:54:02 +01:00			`$(M)texi2html -I doc -monolithic --init-file $(SRC_PATH)/doc/t2h.init --output $@ $<`
build: move documentation rules to doc/Makefile Signed-off-by: Mans Rullgard <mans@mansr.com> 2011-06-06 19:03:22 +02:00
			`doc/%.pod: TAG = POD`
Generate manpages for AV{Format,Codec}Context AVOptions. 2012-03-14 20:08:50 +01:00			`doc/%.pod: doc/%.texi $(GENTEXI)`
build: move documentation rules to doc/Makefile Signed-off-by: Mans Rullgard <mans@mansr.com> 2011-06-06 19:03:22 +02:00			`$(Q)$(TEXIDEP)`
doc/Makefile: invoke perl to interpret texi2pod.pl Do not rely on shebang directive in the script, whose exact behavior is system dependent. 2012-08-10 11:49:27 +02:00			`$(M)perl $(SRC_PATH)/doc/texi2pod.pl -Idoc $< $@`
build: move documentation rules to doc/Makefile Signed-off-by: Mans Rullgard <mans@mansr.com> 2011-06-06 19:03:22 +02:00
			`doc/%.1: TAG = MAN`
Generate manpages for AV{Format,Codec}Context AVOptions. 2012-03-14 20:08:50 +01:00			`doc/%.1: doc/%.pod $(GENTEXI)`
build: move documentation rules to doc/Makefile Signed-off-by: Mans Rullgard <mans@mansr.com> 2011-06-06 19:03:22 +02:00			`$(M)pod2man --section=1 --center=" " --release=" " $< > $@`

build: fix doc generation errors in parallel builds The $(dir) function used to construct OBJDIRS includes a trailing slash in the names returned, which GNU make 3.82 does not match to the slash-less 'doc' in the documentation dependencies, causing parallel build to fail. Adding a slash fixes this and still works with make 3.81. Signed-off-by: Mans Rullgard <mans@mansr.com> 2012-03-27 23:42:41 +02:00			`$(DOCS): \| doc/`
build: create output directories as needed Signed-off-by: Mans Rullgard <mans@mansr.com> 2011-06-28 19:45:13 +02:00
build: Fix documentation dependencies and rules 2012-07-12 03:41:25 +02:00			`install-man:`

build: extend documentation building mechanism Allow to select specific documentation components, and reliably check for component dependencies. In particular, check for perl presence on the system. 2012-08-09 23:37:28 +02:00			`ifdef CONFIG_MANPAGES`
build: move documentation rules to doc/Makefile Signed-off-by: Mans Rullgard <mans@mansr.com> 2011-06-06 19:03:22 +02:00			`install-progs-$(CONFIG_DOC): install-man`

			`install-man: $(MANPAGES)`
			`$(Q)mkdir -p "$(MANDIR)/man1"`
			`$(INSTALL) -m 644 $(MANPAGES) "$(MANDIR)/man1"`
build: Fix documentation dependencies and rules 2012-07-12 03:41:25 +02:00			`endif`
build: move documentation rules to doc/Makefile Signed-off-by: Mans Rullgard <mans@mansr.com> 2011-06-06 19:03:22 +02:00
			`uninstall: uninstall-man`

			`uninstall-man:`
			`$(RM) $(addprefix "$(MANDIR)/man1/",$(ALLMANPAGES))`

			`clean::`
Merge remote-tracking branch 'qatar/master' * qatar/master: (27 commits) avconv: free packet in write_frame() when discarding due to frame number limit FATE: use +/- flag option syntax for vp8 emu-edge tests lavf: make av_interleave_packet_per_dts() private. lavf: deprecate av_read_packet(). oggdec: output correct timestamps for Vorbis avconv: pass input stream timestamps to audio encoders lavc: shrink encoded audio packet size after encoding. xa: set correct bit rate xa: do not set bit_rate, block_align, or bits_per_coded_sample xa: fix end-of-file handling xa: fix timestamp calculation bink: fix typo in FFALIGN() argument bink: align plane width to 8 when calculating bundle sizes doc: pass -Idoc texi2html and texi2pod doc: texi2pod: add -I flag movenc: Add a min_frag_duration option rtsp: Set the default delay to 0.1 s for the RTSP/SDP/RTP demuxers libavformat: Set the default for the max_delay option to -1 Generate manpages for AV{Format,Codec}Context AVOptions. doc/avconv: remove entries for AVOptions. ... Conflicts: doc/Makefile doc/ffmpeg.texi doc/muxers.texi ffmpeg.c libavcodec/Makefile libavcodec/options.c libavcodec/vp8.c libavformat/options.c tests/fate/demux.mak tests/ref/fate/truemotion1-15 tests/ref/fate/truemotion1-24 Merged-by: Michael Niedermayer <michaelni@gmx.at> 2012-03-21 00:15:18 +01:00			`$(RM) $(TXTPAGES) doc/.html doc/.pod doc/.1 $(CLEANSUFFIXES:%=doc/%) doc/avoptions_.texi`
build: move documentation rules to doc/Makefile Signed-off-by: Mans Rullgard <mans@mansr.com> 2011-06-06 19:03:22 +02:00
			`-include $(wildcard $(DOCS:%=%.d))`

doc/Makefile: add doc target, as an alias for "documentation" Consistent with --enable-doc, and easier to type. 2012-08-11 11:58:57 +02:00			`.PHONY: doc documentation`