# HG changeset patch # User diego # Date 1260756110 0 # Node ID 253fb126c4eea52af91232e9ba65292ccf7326b4 # Parent 51c429db3e68b9d09a6ded5d02dc4a2bf3fcce54 Drop support for per-language XSL stylesheets. The feature was never properly used and provides little benefit. diff -r 51c429db3e68 -r 253fb126c4ee DOCS/xml/Makefile.inc --- 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 diff -r 51c429db3e68 -r 253fb126c4ee DOCS/xml/README.maintainers --- 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: - - - - - - - - - - html-chunk.xsl: - - - - - - - - - - - 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 and tags - (please, pay attention to quotes): - - - - -5) In each translated file after the tag you must put a note +3) In each translated file after the tag you must put a note like , where 2 is the revision of corresponding English file (see comment at the top of file).