annotate DOCS/xml/Makefile @ 29965:1bff8cc9ca6b

Do not build monolithic documentation in a separate directory.
author diego
date Sun, 13 Dec 2009 22:51:55 +0000
parents 5513e1981e0e
children 01e66f959361
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
9674
461f71ba8af4 XML version of MPlayer's doc
nicolas
parents:
diff changeset
1 # Makefile for generating the HTML documentation
461f71ba8af4 XML version of MPlayer's doc
nicolas
parents:
diff changeset
2
27296
a316bc1ea84d Only build the documentation in the languages requested from configure.
diego
parents: 23492
diff changeset
3 include ../../config.mak
9674
461f71ba8af4 XML version of MPlayer's doc
nicolas
parents:
diff changeset
4
29965
1bff8cc9ca6b Do not build monolithic documentation in a separate directory.
diego
parents: 29964
diff changeset
5 # Generated HTML files go here.
1bff8cc9ca6b Do not build monolithic documentation in a separate directory.
diego
parents: 29964
diff changeset
6 HTML = ../HTML
9674
461f71ba8af4 XML version of MPlayer's doc
nicolas
parents:
diff changeset
7
11818
c219c245aa50 Build target names shortened.
diego
parents: 11817
diff changeset
8 all: html-chunked html-single
9674
461f71ba8af4 XML version of MPlayer's doc
nicolas
parents:
diff changeset
9
10309
3c0e1b182fbc XML autoconfiguration by Dmitry Baryshkov <lumag@qnc.ru> with some
diego
parents: 10110
diff changeset
10 help:
3c0e1b182fbc XML autoconfiguration by Dmitry Baryshkov <lumag@qnc.ru> with some
diego
parents: 10110
diff changeset
11 @echo "Targets:"
3c0e1b182fbc XML autoconfiguration by Dmitry Baryshkov <lumag@qnc.ru> with some
diego
parents: 10110
diff changeset
12 @echo "********"
27296
a316bc1ea84d Only build the documentation in the languages requested from configure.
diego
parents: 23492
diff changeset
13 @echo "all : Build everything for configured languages (default)."
a316bc1ea84d Only build the documentation in the languages requested from configure.
diego
parents: 23492
diff changeset
14 @echo "html-single : HTML documentation for configured languages (single file)"
11883
51e14a023339 Structure rewritten, to allow single language build and some simplifications.
wight
parents: 11841
diff changeset
15 @echo "html-single-LANG : As above, but only one language."
27296
a316bc1ea84d Only build the documentation in the languages requested from configure.
diego
parents: 23492
diff changeset
16 @echo "html-chunked : HTML documentation for configured languages (multiple files)"
11883
51e14a023339 Structure rewritten, to allow single language build and some simplifications.
wight
parents: 11841
diff changeset
17 @echo "html-chunked-LANG : As above, but only one language."
15126
6555c01128b7 Support syntax checking only
wight
parents: 15101
diff changeset
18 @echo "xmllint : Check syntax of all xml files."
15135
58c628554a33 Typo fix
gpoirier
parents: 15126
diff changeset
19 @echo "xmllint-LANG : Check syntax of LANG xml files."
29965
1bff8cc9ca6b Do not build monolithic documentation in a separate directory.
diego
parents: 29964
diff changeset
20 @echo "clean : Purge the 'HTML' directory."
15101
04a5b6407cb6 Add releaseclean target to remove generated files but keep the HTML.
diego
parents: 14393
diff changeset
21 @echo "releaseclean : Remove generated files but keep the HTML."
11188
6dfed0b2a300 Add support for building all-in-one HTML docs. (Files go to DOCS/HTML-single)
lumag
parents: 11130
diff changeset
22 @echo "distclean : Remove ALL generated files."
27296
a316bc1ea84d Only build the documentation in the languages requested from configure.
diego
parents: 23492
diff changeset
23 @echo "Substitute LANG for one of $(DOC_LANG_ALL)"
9674
461f71ba8af4 XML version of MPlayer's doc
nicolas
parents:
diff changeset
24
29960
67727e918ec2 Declare common dependencies for chunked and single HTML targets together.
diego
parents: 29958
diff changeset
25 html-chunked html-single: xsltproc.sh xmllint.sh
29964
5513e1981e0e - Remove now unnecessary dependency on intermediate directories.
diego
parents: 29963
diff changeset
26 html-chunked: $(addprefix html-chunked-,$(DOC_LANGS))
5513e1981e0e - Remove now unnecessary dependency on intermediate directories.
diego
parents: 29963
diff changeset
27 html-single: $(addprefix html-single-,$(DOC_LANGS))
11188
6dfed0b2a300 Add support for building all-in-one HTML docs. (Files go to DOCS/HTML-single)
lumag
parents: 11130
diff changeset
28
27296
a316bc1ea84d Only build the documentation in the languages requested from configure.
diego
parents: 23492
diff changeset
29 xmllint: xmllint.sh $(addprefix xmllint-,$(DOC_LANG_ALL))
15126
6555c01128b7 Support syntax checking only
wight
parents: 15101
diff changeset
30
29965
1bff8cc9ca6b Do not build monolithic documentation in a separate directory.
diego
parents: 29964
diff changeset
31 $(foreach lang,$(DOC_LANG_ALL),$(HTML)/$(lang)):
28216
119286d52a9a Get rid of pointless chunked-dir and single-dir targets.
diego
parents: 28215
diff changeset
32 -mkdir -p $@
119286d52a9a Get rid of pointless chunked-dir and single-dir targets.
diego
parents: 28215
diff changeset
33
11326
23192e33fad5 Dependencies for autogenerated files added.
diego
parents: 11206
diff changeset
34 xsltproc.sh xmllint.sh:
11841
67550c3b21a5 Make the build system print everything it does.
diego
parents: 11818
diff changeset
35 sh configure
11063
f44ee899fbf1 clean -> clean-html
gabucino
parents: 11052
diff changeset
36
11883
51e14a023339 Structure rewritten, to allow single language build and some simplifications.
wight
parents: 11841
diff changeset
37 define lang-def
29965
1bff8cc9ca6b Do not build monolithic documentation in a separate directory.
diego
parents: 29964
diff changeset
38 html-chunked-$(1): $(HTML)/$(1) xsltproc.sh xmllint.sh
29962
fd112c1ef46e Simplify some commands via automatic variables.
diego
parents: 29961
diff changeset
39 $(MAKE) HTMLDIR=../$$< -C $(1) html-chunked
11883
51e14a023339 Structure rewritten, to allow single language build and some simplifications.
wight
parents: 11841
diff changeset
40
29965
1bff8cc9ca6b Do not build monolithic documentation in a separate directory.
diego
parents: 29964
diff changeset
41 html-single-$(1): $(HTML)/$(1) xsltproc.sh xmllint.sh
29962
fd112c1ef46e Simplify some commands via automatic variables.
diego
parents: 29961
diff changeset
42 $(MAKE) HTMLFILE=../$$</MPlayer.html -C $(1) html-single
11883
51e14a023339 Structure rewritten, to allow single language build and some simplifications.
wight
parents: 11841
diff changeset
43
15126
6555c01128b7 Support syntax checking only
wight
parents: 15101
diff changeset
44 xmllint-$(1): xmllint.sh
29963
550b899f9b7a Do not pointlessly set the HTMLFILE variable when running xmllint.
diego
parents: 29962
diff changeset
45 $(MAKE) -C $(1) xmllint
11883
51e14a023339 Structure rewritten, to allow single language build and some simplifications.
wight
parents: 11841
diff changeset
46 endef
51e14a023339 Structure rewritten, to allow single language build and some simplifications.
wight
parents: 11841
diff changeset
47
27296
a316bc1ea84d Only build the documentation in the languages requested from configure.
diego
parents: 23492
diff changeset
48 $(foreach lang, $(DOC_LANG_ALL),$(eval $(call lang-def,$(lang))))
22467
7336cfb3b88f Merge all .PHONY target declarations.
diego
parents: 21649
diff changeset
49
28220
e8a6bde9ef9e cosmetics: Move clean targets to the bottom.
diego
parents: 28219
diff changeset
50 clean:
29965
1bff8cc9ca6b Do not build monolithic documentation in a separate directory.
diego
parents: 29964
diff changeset
51 rm -rf $(HTML)
28220
e8a6bde9ef9e cosmetics: Move clean targets to the bottom.
diego
parents: 28219
diff changeset
52
28221
ded986da716f nonrecursive releaseclean target
diego
parents: 28220
diff changeset
53 releaseclean:
ded986da716f nonrecursive releaseclean target
diego
parents: 28220
diff changeset
54 rm -f $(foreach lang,$(DOC_LANG_ALL),$(lang)/main.xml)
ded986da716f nonrecursive releaseclean target
diego
parents: 28220
diff changeset
55 rm -f $$(find . -name *.xml -type l)
28222
f97b67465500 Skip pointless ignoring return value of 'rm -f'.
diego
parents: 28221
diff changeset
56 rm -f html-chunk.xsl html-single.xsl xsltproc.sh xmllint.sh
28220
e8a6bde9ef9e cosmetics: Move clean targets to the bottom.
diego
parents: 28219
diff changeset
57
e8a6bde9ef9e cosmetics: Move clean targets to the bottom.
diego
parents: 28219
diff changeset
58 distclean: clean releaseclean
e8a6bde9ef9e cosmetics: Move clean targets to the bottom.
diego
parents: 28219
diff changeset
59
29958
c5ddf34d6f57 xmllint.sh is not a phony target.
diego
parents: 28223
diff changeset
60 .PHONY: all help html-chunked* html-single* xmllint xmllint-* *clean*