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/libavfilter.html                                      \
              doc/platform.html                                         \

TXTPAGES    = doc/fate.txt                                              \


DOCS = $(HTMLPAGES) $(MANPAGES) $(PODPAGES)
ifdef HAVE_MAKEINFO
DOCS += $(TXTPAGES)
endif

all-$(CONFIG_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

doc/print_options.o: libavformat/options_table.h libavcodec/options_table.h

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

$(GENTEXI): TAG = GENTEXI
$(GENTEXI): doc/avoptions_%.texi: doc/print_options
	$(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)$(SRC_PATH)/doc/texi2pod.pl -Idoc $< $@

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

$(DOCS): | doc/

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

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

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: documentation
build: move documentation rules to doc/Makefile Signed-off-by: Mans Rullgard <mans@mansr.com> 2011-06-06 17:03:22 +00:00			`MANPAGES = $(PROGS-yes:%=doc/%.1)`
			`PODPAGES = $(PROGS-yes:%=doc/%.pod)`
build: merge lists of HTML documentation targets 2011-12-07 20:49:53 +00: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 00:33:07 +00:00			`doc/fate.html \`
build: merge lists of HTML documentation targets 2011-12-07 20:49:53 +00:00			`doc/general.html \`
doc: port the git-howto to texinfo 2011-12-03 17:06:14 +00:00			`doc/git-howto.html \`
build: merge lists of HTML documentation targets 2011-12-07 20:49:53 +00:00			`doc/libavfilter.html \`
doc: split platform specific information Move the platform-specific information in its own file. 2011-12-03 20:25:04 +00:00			`doc/platform.html \`
build: move documentation rules to doc/Makefile Signed-off-by: Mans Rullgard <mans@mansr.com> 2011-06-06 17:03:22 +00: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-19 23:28:47 +00:00			`TXTPAGES = doc/fate.txt \`


build: merge lists of HTML documentation targets 2011-12-07 20:49:53 +00:00			`DOCS = $(HTMLPAGES) $(MANPAGES) $(PODPAGES)`
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-19 23:28:47 +00:00			`ifdef HAVE_MAKEINFO`
			`DOCS += $(TXTPAGES)`
			`endif`
build: move documentation rules to doc/Makefile Signed-off-by: Mans Rullgard <mans@mansr.com> 2011-06-06 17:03:22 +00:00
			`all-$(CONFIG_DOC): documentation`

			`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-19 23:27:22 +00: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 17:03:22 +00: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-19 23:28:47 +00: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 19:08:50 +00:00			`doc/print_options.o: libavformat/options_table.h libavcodec/options_table.h`

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

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

build: move documentation rules to doc/Makefile Signed-off-by: Mans Rullgard <mans@mansr.com> 2011-06-06 17:03:22 +00:00			`doc/%.html: TAG = HTML`
Generate manpages for AV{Format,Codec}Context AVOptions. 2012-03-14 19:08:50 +00: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 17:03:22 +00: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 10:54:02 +00: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 17:03:22 +00:00
			`doc/%.pod: TAG = POD`
Generate manpages for AV{Format,Codec}Context AVOptions. 2012-03-14 19:08:50 +00:00			`doc/%.pod: doc/%.texi $(GENTEXI)`
build: move documentation rules to doc/Makefile Signed-off-by: Mans Rullgard <mans@mansr.com> 2011-06-06 17:03:22 +00: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 10:54:02 +00:00			`$(M)$(SRC_PATH)/doc/texi2pod.pl -Idoc $< $@`
build: move documentation rules to doc/Makefile Signed-off-by: Mans Rullgard <mans@mansr.com> 2011-06-06 17:03:22 +00:00
			`doc/%.1: TAG = MAN`
Generate manpages for AV{Format,Codec}Context AVOptions. 2012-03-14 19:08:50 +00:00			`doc/%.1: doc/%.pod $(GENTEXI)`
build: move documentation rules to doc/Makefile Signed-off-by: Mans Rullgard <mans@mansr.com> 2011-06-06 17:03:22 +00: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 21:42:41 +00:00			`$(DOCS): \| doc/`
build: create output directories as needed Signed-off-by: Mans Rullgard <mans@mansr.com> 2011-06-28 17:45:13 +00:00
build: move documentation rules to doc/Makefile Signed-off-by: Mans Rullgard <mans@mansr.com> 2011-06-06 17:03:22 +00:00			`install-progs-$(CONFIG_DOC): install-man`

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

			`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-20 23:15:18 +00: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 17:03:22 +00:00
			`-include $(wildcard $(DOCS:%=%.d))`

			`.PHONY: documentation`