changeset 29978:253fb126c4ee

Drop support for per-language XSL stylesheets. The feature was never properly used and provides little benefit.
author diego
date Mon, 14 Dec 2009 02:01:50 +0000
parents 51c429db3e68
children 4d2792f3a070
files DOCS/xml/Makefile.inc DOCS/xml/README.maintainers
diffstat 2 files changed, 2 insertions(+), 57 deletions(-) [+]
line wrap: on
line diff
--- a/DOCS/xml/Makefile.inc	Mon Dec 14 02:00:25 2009 +0000
+++ b/DOCS/xml/Makefile.inc	Mon Dec 14 02:01:50 2009 +0000
@@ -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
--- a/DOCS/xml/README.maintainers	Mon Dec 14 02:00:25 2009 +0000
+++ b/DOCS/xml/README.maintainers	Mon Dec 14 02:01:50 2009 +0000
@@ -14,9 +14,7 @@
 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 @@
 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).