From 16a890af7de8fe55f7cafeb3200b47e6b41c3649 Mon Sep 17 00:00:00 2001
From: Shaun McCance <shaunm@redhat.com>
Date: Fri, 16 Oct 2020 11:53:48 -0400
Subject: Some doc updates for text templates

---
 xslt/common/html.xsl | 12 ++++++++++++
 xslt/common/tmpl.xsl |  6 +++---
 2 files changed, 15 insertions(+), 3 deletions(-)

(limited to 'xslt')

diff --git a/xslt/common/html.xsl b/xslt/common/html.xsl
index 453d205c..17778344 100644
--- a/xslt/common/html.xsl
+++ b/xslt/common/html.xsl
@@ -1222,6 +1222,10 @@ common spacings for block-level elements like paragraphs and lists, defines
 styles for links, and defines four common wrapper divs: `header`, `side`,
 `body`, and `footer`.
 
+This template uses text templates to keep the actual CSS content in a
+separate file, `css/core.css.tmpl`, and do simple param substitutions.
+This makes it easier to update the CSS without working with XSLT.
+
 All parameters can be automatically computed if not provided.
 -->
 <xsl:template name="html.css.core">
@@ -1266,6 +1270,10 @@ the simpler element names from Mallard, although there some class names which
 are not taken from Mallard. Stylesheets which convert to HTML should use the
 appropriate common classes.
 
+This template uses text templates to keep the actual CSS content in a
+separate file, `css/elements.css.tmpl`, and do simple param substitutions.
+This makes it easier to update the CSS without working with XSLT.
+
 All parameters can be automatically computed if not provided.
 -->
 <xsl:template name="html.css.elements">
@@ -1377,6 +1385,10 @@ is broken up into chunks and wrapped in HTML elements with particular classes.
 This template outputs CSS to match those elements and style them with the
 built-in themeable colors from {color}.
 
+This template uses text templates to keep the actual CSS content in a
+separate file, `css/syntax.css.tmpl`, and do simple param substitutions.
+This makes it easier to update the CSS without working with XSLT.
+
 All parameters can be automatically computed if not provided.
 -->
 <xsl:template name="html.css.syntax">
diff --git a/xslt/common/tmpl.xsl b/xslt/common/tmpl.xsl
index 4df8e1ed..c52a95cf 100644
--- a/xslt/common/tmpl.xsl
+++ b/xslt/common/tmpl.xsl
@@ -24,7 +24,7 @@ along with this program; see the file COPYING.LGPL. If not, see
 <!--!!==========================================================================
 Text Templates
 Perform simple substitutions in text files.
-@revision[version=40 date=FIXME status=FIXME]
+@revision[version=40 date=2020-10-16 status=final]
 
 This stylesheet contains templates to perform simple substitutions on text
 and files containing text. The primary purpose of these templates is to allow
@@ -48,7 +48,7 @@ This stylesheet was added in version 40.
 <!--**==========================================================================
 tmpl.file
 Perform text substitutions on a file.
-@revision[version=40 date=FIXME status=FIXME]
+@revision[version=40 date=2020-10-16 status=final]
 
 [xsl:params]
 $file: The filename of the file to process for substitutions.
@@ -100,7 +100,7 @@ This template was added in version 40.
 <!--**==========================================================================
 tmpl.text
 Perform text substitutions on some text.
-@revision[version=40 date=FIXME status=FIXME]
+@revision[version=40 date=2020-10-16 status=final]
 
 [xsl:params]
 $text: The text to process for substitutions.
-- 
cgit v1.2.1