Add comment explaining %t etc.

diff --git a/gentext/xsl/xsl.xsl b/gentext/xsl/xsl.xsl
index 741bb0096a2e18fed89211211b27e4a8d9954782..6c752f1517d3a2f431f9969308a42191bc8b4f2f 100644 (file)
--- a/gentext/xsl/xsl.xsl
+++ b/gentext/xsl/xsl.xsl
@@ -55,6 +55,19 @@
     <xsl:text>&#10;</xsl:text>
     <xsl:comment> ******************************************************************** </xsl:comment>
     <xsl:text>&#10;</xsl:text>
+    <xsl:comment> In these files, % with a letter is used for a placeholder: </xsl:comment>
+    <xsl:text>&#10;</xsl:text>
+    <xsl:comment>   %t is the current element's title </xsl:comment>
+    <xsl:text>&#10;</xsl:text>
+    <xsl:comment>   %s is the current element's subtitle (if applicable)</xsl:comment>
+    <xsl:text>&#10;</xsl:text>
+    <xsl:comment>   %n is the current element's number label</xsl:comment>
+    <xsl:text>&#10;</xsl:text>
+    <xsl:comment>   %p is the current element's page number (if applicable)</xsl:comment>
+    <xsl:text>&#10;</xsl:text>
+    <xsl:comment> ******************************************************************** </xsl:comment>
+    <xsl:text>&#10;</xsl:text>
+    <xsl:text>&#10;</xsl:text>
 
     <xsl:apply-templates/>