[MPlayer-DOCS] r30020 - in trunk/DOCS/xml: Makefile.inc README.maintainers
diego
subversion at mplayerhq.hu
Mon Dec 14 03:01:50 CET 2009
Author: diego
Date: Mon Dec 14 03:01:50 2009
New Revision: 30020
Log:
Drop support for per-language XSL stylesheets.
The feature was never properly used and provides little benefit.
Modified:
trunk/DOCS/xml/Makefile.inc
trunk/DOCS/xml/README.maintainers
Modified: trunk/DOCS/xml/Makefile.inc
==============================================================================
--- trunk/DOCS/xml/Makefile.inc Mon Dec 14 03:00:25 2009 (r30019)
+++ trunk/DOCS/xml/Makefile.inc Mon Dec 14 03:01:50 2009 (r30020)
@@ -2,25 +2,11 @@
# Makefile.inc for Makefiles in subdirectories.
#
-# Use customized html-chunk.xsl and/or html-single.xsl file if they exist...
-# Also add html-common.xsl to depends if it exists.
-COMMON_XSL_DEPS := ../html-common.xsl $(wildcard html-common.xsl)
-
-ifeq (html-chunk.xsl,$(wildcard html-chunk.xsl))
-HTML_CHUNK_XSL := html-chunk.xsl
-CHUNK_XSL_DEPS := $(HTML_CHUNK_XSL) ../html-chunk.xsl $(COMMON_XSL_DEPS)
-else
HTML_CHUNK_XSL := ../html-chunk.xsl
CHUNK_XSL_DEPS := $(HTML_CHUNK_XSL) ../html-common.xsl
-endif
-ifeq (html-single.xsl,$(wildcard html-single.xsl))
-HTML_SINGLE_XSL := html-single.xsl
-XSL_DEPS := $(HTML_SINGLE_XSL) ../html-single.xsl $(COMMON_XSL_DEPS)
-else
HTML_SINGLE_XSL := ../html-single.xsl
XSL_DEPS := $(HTML_SINGLE_XSL) ../html-common.xsl
-endif
# This is the main target...
all: html-chunked html-single
Modified: trunk/DOCS/xml/README.maintainers
==============================================================================
--- trunk/DOCS/xml/README.maintainers Mon Dec 14 03:00:25 2009 (r30019)
+++ trunk/DOCS/xml/README.maintainers Mon Dec 14 03:01:50 2009 (r30020)
@@ -14,9 +14,7 @@ IMPORTANT: Do NOT place sensitive files
Each subdirectory must have a Makefile. Its purpose is to include
the toplevel Makefile.inc file (with the rules to build the docs)
and add dependency information to the main target, $(HTMLDIR)/index.html.
-The main target usually depends on all the XML and XSL files in the
-subdirectory. (Note that the toplevel *.xsl files are added automatically
-by Makefile.inc, so you do not have to list them.)
+The main target usually depends on all the XML files in the subdirectory.
Adding new translations
@@ -28,46 +26,7 @@ Adding new translations
2) Make sure to create a 'Makefile' for the translation -- you can
use 'en/Makefile' as an example.
-3) If you want to use a customized XSL stylesheet, create one and name it
- 'html-common.xsl'. Also create two additional XSL stylesheets
- ('html-single.xsl' and 'html-chunk.xsl'), with content such as this:
-
- html-single.xsl:
-
- <?xml version="1.0" encoding="ISO-8859-1"?>
- <xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
- version="1.0">
-
- <xsl:import href="../html-single.xsl"/>
- <xsl:include href="html-common.xsl"/>
-
- </xsl:stylesheet>
-
- html-chunk.xsl:
-
- <?xml version="1.0" encoding="ISO-8859-1"?>
- <xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
- version="1.0">
-
- <xsl:import href="../html-chunk.xsl"/>
- <xsl:include href="html-common.xsl"/>
-
- </xsl:stylesheet>
-
-
- Note: You mustn't xsl:include or xsl:import chunk.xsl directly!
- Including it can (and will) break building of documentation if chunk.xsl
- is installed at a nonstandard location.
-
-4) If you wish to change the output encoding of generated files, create
- html-common.xsl as suggested in step 4) and add strings such as these
- somewhere between the <xsl:stylesheet ...> and </xsl:stylesheet> tags
- (please, pay attention to quotes):
-
- <xsl:param name="chunker.output.encoding" select="'your_encoding'"/>
- <xsl:output encoding="your_encoding"/>
-
-5) In each translated file after the <?xml ... ?> tag you must put a note
+3) In each translated file after the <?xml ... ?> tag you must put a note
like <!-- synced with r2 -->, where 2 is the revision of corresponding
English file (see comment at the top of file).
More information about the MPlayer-DOCS
mailing list