annotate DOCS/xml/Makefile @ 29963:550b899f9b7a

Do not pointlessly set the HTMLFILE variable when running xmllint.
author diego
date Sun, 13 Dec 2009 22:25:08 +0000
parents fd112c1ef46e
children 5513e1981e0e
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
11200
eae346fd3769 Big consistency overhaul, targets and variables renamed to *-single and
diego
parents: 11188
diff changeset
5 # Generated chunked HTML files go here.
eae346fd3769 Big consistency overhaul, targets and variables renamed to *-single and
diego
parents: 11188
diff changeset
6 HTML_CHUNKED = ../HTML
9759
56be5a7b02a2 Minor improvement: don't create empty dirs.
lumag
parents: 9674
diff changeset
7
11200
eae346fd3769 Big consistency overhaul, targets and variables renamed to *-single and
diego
parents: 11188
diff changeset
8 # Generated single HTML files go here.
eae346fd3769 Big consistency overhaul, targets and variables renamed to *-single and
diego
parents: 11188
diff changeset
9 HTML_SINGLE = ../HTML-single
9674
461f71ba8af4 XML version of MPlayer's doc
nicolas
parents:
diff changeset
10
11818
c219c245aa50 Build target names shortened.
diego
parents: 11817
diff changeset
11 all: html-chunked html-single
9674
461f71ba8af4 XML version of MPlayer's doc
nicolas
parents:
diff changeset
12
10309
3c0e1b182fbc XML autoconfiguration by Dmitry Baryshkov <lumag@qnc.ru> with some
diego
parents: 10110
diff changeset
13 help:
3c0e1b182fbc XML autoconfiguration by Dmitry Baryshkov <lumag@qnc.ru> with some
diego
parents: 10110
diff changeset
14 @echo "Targets:"
3c0e1b182fbc XML autoconfiguration by Dmitry Baryshkov <lumag@qnc.ru> with some
diego
parents: 10110
diff changeset
15 @echo "********"
27296
a316bc1ea84d Only build the documentation in the languages requested from configure.
diego
parents: 23492
diff changeset
16 @echo "all : Build everything for configured languages (default)."
a316bc1ea84d Only build the documentation in the languages requested from configure.
diego
parents: 23492
diff changeset
17 @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
18 @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
19 @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
20 @echo "html-chunked-LANG : As above, but only one language."
15126
6555c01128b7 Support syntax checking only
wight
parents: 15101
diff changeset
21 @echo "xmllint : Check syntax of all xml files."
15135
58c628554a33 Typo fix
gpoirier
parents: 15126
diff changeset
22 @echo "xmllint-LANG : Check syntax of LANG xml files."
11206
e7534574320c html.xsl ---> html-single.xsl + more consistency + small fixes
diego
parents: 11200
diff changeset
23 @echo "clean : Purge the 'HTML' and 'HTML-single' directories."
15101
04a5b6407cb6 Add releaseclean target to remove generated files but keep the HTML.
diego
parents: 14393
diff changeset
24 @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
25 @echo "distclean : Remove ALL generated files."
27296
a316bc1ea84d Only build the documentation in the languages requested from configure.
diego
parents: 23492
diff changeset
26 @echo "Substitute LANG for one of $(DOC_LANG_ALL)"
9674
461f71ba8af4 XML version of MPlayer's doc
nicolas
parents:
diff changeset
27
29960
67727e918ec2 Declare common dependencies for chunked and single HTML targets together.
diego
parents: 29958
diff changeset
28 html-chunked html-single: xsltproc.sh xmllint.sh
67727e918ec2 Declare common dependencies for chunked and single HTML targets together.
diego
parents: 29958
diff changeset
29 html-chunked: $(HTML_CHUNKED) $(addprefix html-chunked-,$(DOC_LANGS))
67727e918ec2 Declare common dependencies for chunked and single HTML targets together.
diego
parents: 29958
diff changeset
30 html-single: $(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
31
27296
a316bc1ea84d Only build the documentation in the languages requested from configure.
diego
parents: 23492
diff changeset
32 xmllint: xmllint.sh $(addprefix xmllint-,$(DOC_LANG_ALL))
15126
6555c01128b7 Support syntax checking only
wight
parents: 15101
diff changeset
33
29961
49149ee9cdfb Create required directories directly without intermediate steps.
diego
parents: 29960
diff changeset
34 $(foreach lang,$(DOC_LANG_ALL),$(HTML_CHUNKED)/$(lang) $(HTML_SINGLE)/$(lang)):
28216
119286d52a9a Get rid of pointless chunked-dir and single-dir targets.
diego
parents: 28215
diff changeset
35 -mkdir -p $@
119286d52a9a Get rid of pointless chunked-dir and single-dir targets.
diego
parents: 28215
diff changeset
36
11326
23192e33fad5 Dependencies for autogenerated files added.
diego
parents: 11206
diff changeset
37 xsltproc.sh xmllint.sh:
11841
67550c3b21a5 Make the build system print everything it does.
diego
parents: 11818
diff changeset
38 sh configure
11063
f44ee899fbf1 clean -> clean-html
gabucino
parents: 11052
diff changeset
39
11883
51e14a023339 Structure rewritten, to allow single language build and some simplifications.
wight
parents: 11841
diff changeset
40 define lang-def
29961
49149ee9cdfb Create required directories directly without intermediate steps.
diego
parents: 29960
diff changeset
41 html-chunked-$(1): $(HTML_CHUNKED)/$(1) xsltproc.sh xmllint.sh
29962
fd112c1ef46e Simplify some commands via automatic variables.
diego
parents: 29961
diff changeset
42 $(MAKE) HTMLDIR=../$$< -C $(1) html-chunked
11883
51e14a023339 Structure rewritten, to allow single language build and some simplifications.
wight
parents: 11841
diff changeset
43
29961
49149ee9cdfb Create required directories directly without intermediate steps.
diego
parents: 29960
diff changeset
44 html-single-$(1): $(HTML_SINGLE)/$(1) xsltproc.sh xmllint.sh
29962
fd112c1ef46e Simplify some commands via automatic variables.
diego
parents: 29961
diff changeset
45 $(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
46
15126
6555c01128b7 Support syntax checking only
wight
parents: 15101
diff changeset
47 xmllint-$(1): xmllint.sh
29963
550b899f9b7a Do not pointlessly set the HTMLFILE variable when running xmllint.
diego
parents: 29962
diff changeset
48 $(MAKE) -C $(1) xmllint
11883
51e14a023339 Structure rewritten, to allow single language build and some simplifications.
wight
parents: 11841
diff changeset
49 endef
51e14a023339 Structure rewritten, to allow single language build and some simplifications.
wight
parents: 11841
diff changeset
50
27296
a316bc1ea84d Only build the documentation in the languages requested from configure.
diego
parents: 23492
diff changeset
51 $(foreach lang, $(DOC_LANG_ALL),$(eval $(call lang-def,$(lang))))
22467
7336cfb3b88f Merge all .PHONY target declarations.
diego
parents: 21649
diff changeset
52
28220
e8a6bde9ef9e cosmetics: Move clean targets to the bottom.
diego
parents: 28219
diff changeset
53 clean:
e8a6bde9ef9e cosmetics: Move clean targets to the bottom.
diego
parents: 28219
diff changeset
54 rm -rf $(HTML_CHUNKED) $(HTML_SINGLE)
e8a6bde9ef9e cosmetics: Move clean targets to the bottom.
diego
parents: 28219
diff changeset
55
28221
ded986da716f nonrecursive releaseclean target
diego
parents: 28220
diff changeset
56 releaseclean:
ded986da716f nonrecursive releaseclean target
diego
parents: 28220
diff changeset
57 rm -f $(foreach lang,$(DOC_LANG_ALL),$(lang)/main.xml)
ded986da716f nonrecursive releaseclean target
diego
parents: 28220
diff changeset
58 rm -f $$(find . -name *.xml -type l)
28222
f97b67465500 Skip pointless ignoring return value of 'rm -f'.
diego
parents: 28221
diff changeset
59 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
60
e8a6bde9ef9e cosmetics: Move clean targets to the bottom.
diego
parents: 28219
diff changeset
61 distclean: clean releaseclean
e8a6bde9ef9e cosmetics: Move clean targets to the bottom.
diego
parents: 28219
diff changeset
62
29958
c5ddf34d6f57 xmllint.sh is not a phony target.
diego
parents: 28223
diff changeset
63 .PHONY: all help html-chunked* html-single* xmllint xmllint-* *clean*