annotate DOCS/xml/Makefile @ 28480:a785e0b7e1f2

partial sync with obsolete section removal
author diego
date Tue, 10 Feb 2009 00:15:44 +0000
parents 6080184bef59
children c5ddf34d6f57
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
28216
119286d52a9a Get rid of pointless chunked-dir and single-dir targets.
diego
parents: 28215
diff changeset
28 html-chunked: xsltproc.sh xmllint.sh $(HTML_CHUNKED) $(addprefix html-chunked-,$(DOC_LANGS))
9674
461f71ba8af4 XML version of MPlayer's doc
nicolas
parents:
diff changeset
29
28216
119286d52a9a Get rid of pointless chunked-dir and single-dir targets.
diego
parents: 28215
diff changeset
30 html-single: xsltproc.sh xmllint.sh $(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
28216
119286d52a9a Get rid of pointless chunked-dir and single-dir targets.
diego
parents: 28215
diff changeset
34 $(HTML_CHUNKED) $(HTML_SINGLE):
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
28216
119286d52a9a Get rid of pointless chunked-dir and single-dir targets.
diego
parents: 28215
diff changeset
41 html-chunked-$(1): xsltproc.sh xmllint.sh $(HTML_CHUNKED)
28223
6080184bef59 Do not run mkdir in a subshell.
diego
parents: 28222
diff changeset
42 -mkdir -p $(HTML_CHUNKED)/$(1)
11883
51e14a023339 Structure rewritten, to allow single language build and some simplifications.
wight
parents: 11841
diff changeset
43 $(MAKE) HTMLDIR=../$(HTML_CHUNKED)/$(1) -C $(1) html-chunked
51e14a023339 Structure rewritten, to allow single language build and some simplifications.
wight
parents: 11841
diff changeset
44
28216
119286d52a9a Get rid of pointless chunked-dir and single-dir targets.
diego
parents: 28215
diff changeset
45 html-single-$(1): xsltproc.sh xmllint.sh $(HTML_SINGLE)
28223
6080184bef59 Do not run mkdir in a subshell.
diego
parents: 28222
diff changeset
46 -mkdir -p $(HTML_SINGLE)/$(1)
11883
51e14a023339 Structure rewritten, to allow single language build and some simplifications.
wight
parents: 11841
diff changeset
47 $(MAKE) HTMLFILE=../$(HTML_SINGLE)/$(1)/MPlayer.html -C $(1) html-single
51e14a023339 Structure rewritten, to allow single language build and some simplifications.
wight
parents: 11841
diff changeset
48
15126
6555c01128b7 Support syntax checking only
wight
parents: 15101
diff changeset
49 xmllint-$(1): xmllint.sh
6555c01128b7 Support syntax checking only
wight
parents: 15101
diff changeset
50 $(MAKE) HTMLFILE=../$(HTML_SINGLE)/$(1)/MPlayer.html -C $(1) xmllint
11883
51e14a023339 Structure rewritten, to allow single language build and some simplifications.
wight
parents: 11841
diff changeset
51 endef
51e14a023339 Structure rewritten, to allow single language build and some simplifications.
wight
parents: 11841
diff changeset
52
27296
a316bc1ea84d Only build the documentation in the languages requested from configure.
diego
parents: 23492
diff changeset
53 $(foreach lang, $(DOC_LANG_ALL),$(eval $(call lang-def,$(lang))))
22467
7336cfb3b88f Merge all .PHONY target declarations.
diego
parents: 21649
diff changeset
54
28220
e8a6bde9ef9e cosmetics: Move clean targets to the bottom.
diego
parents: 28219
diff changeset
55 clean:
e8a6bde9ef9e cosmetics: Move clean targets to the bottom.
diego
parents: 28219
diff changeset
56 rm -rf $(HTML_CHUNKED) $(HTML_SINGLE)
e8a6bde9ef9e cosmetics: Move clean targets to the bottom.
diego
parents: 28219
diff changeset
57
28221
ded986da716f nonrecursive releaseclean target
diego
parents: 28220
diff changeset
58 releaseclean:
ded986da716f nonrecursive releaseclean target
diego
parents: 28220
diff changeset
59 rm -f $(foreach lang,$(DOC_LANG_ALL),$(lang)/main.xml)
ded986da716f nonrecursive releaseclean target
diego
parents: 28220
diff changeset
60 rm -f $$(find . -name *.xml -type l)
28222
f97b67465500 Skip pointless ignoring return value of 'rm -f'.
diego
parents: 28221
diff changeset
61 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
62
e8a6bde9ef9e cosmetics: Move clean targets to the bottom.
diego
parents: 28219
diff changeset
63 distclean: clean releaseclean
e8a6bde9ef9e cosmetics: Move clean targets to the bottom.
diego
parents: 28219
diff changeset
64
28216
119286d52a9a Get rid of pointless chunked-dir and single-dir targets.
diego
parents: 28215
diff changeset
65 .PHONY: all help html-chunked* html-single* xmllint* *clean*