From: Mauritz Jeanson <mj@johanneberg.com>
Date: Fri, 22 Feb 2008 15:45:36 +0000 (+0000)
Subject: Added information on how the filename is computed.
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=4098791bd00dc93390a83e52cb9c863773901e54;p=docbook-dsssl

Added information on how the filename is computed.
---

diff --git a/xsl/params/generate.legalnotice.link.xml b/xsl/params/generate.legalnotice.link.xml
index 4f63116ec..534e05050 100644
--- a/xsl/params/generate.legalnotice.link.xml
+++ b/xsl/params/generate.legalnotice.link.xml
@@ -45,5 +45,28 @@ is non-zero, the stylesheet:
   zero, <tag>legalnotice</tag> contents are rendered on the title
   page.</para>
 
+<para>The name of the separate HTML file is computed as follows:
+
+<orderedlist>
+<listitem>
+  <para>If a filename is given by the <tag class="xmlpi">dbhtml filename</tag> 
+processing instruction, that filename is used.</para>
+</listitem>
+<listitem>
+  <para>If the legalnotice has an <tag class="attribute">id</tag>/<tag class="attribute">xml:id</tag> 
+attribute, and if <parameter>use.id.as.filename</parameter> != 0, the filename 
+is the concatenation of the id value and the value of the <parameter>html.ext</parameter> 
+parameter.</para>
+</listitem>
+<listitem>
+  <para>If the legalnotice does not have an <tag class="attribute">id</tag>/<tag class="attribute">xml:id</tag>
+ attribute, or if <parameter>use.id.as.filename</parameter> = 0, the filename is the concatenation of "ln-", 
+auto-generated id value, and <parameter>html.ext</parameter> value.
+  </para>
+</listitem>
+</orderedlist>
+
+</para>
+
 </refsection>
 </refentry>
diff --git a/xsl/params/generate.revhistory.link.xml b/xsl/params/generate.revhistory.link.xml
index f820be9c9..bd70cd91d 100644
--- a/xsl/params/generate.revhistory.link.xml
+++ b/xsl/params/generate.revhistory.link.xml
@@ -24,5 +24,27 @@ to a separate HTML file and a link to the file is
 generated. Otherwise, <tag>revhistory</tag> contents are rendered on
 the title page.</para>
 
+<para>The name of the separate HTML file is computed as follows:
+
+<orderedlist>
+<listitem>
+  <para>If a filename is given by the <tag class="xmlpi">dbhtml filename</tag> processing instruction, 
+that filename is used.</para>
+</listitem>
+<listitem>
+  <para>If the revhistory has an <tag class="attribute">id</tag>/<tag class="attribute">xml:id</tag> 
+attribute, and if <parameter>use.id.as.filename</parameter> != 0, the filename is the concatenation of 
+the id value and the value of the <parameter>html.ext</parameter> parameter.</para>
+</listitem>
+<listitem>
+  <para>If the revhistory does not have an <tag class="attribute">id</tag>/<tag class="attribute">xml:id</tag> 
+attribute, or if <parameter>use.id.as.filename</parameter> = 0, the filename is the concatenation of "rh-", 
+auto-generated id value, and <parameter>html.ext</parameter> value.
+  </para>
+</listitem>
+</orderedlist>
+
+</para>
+
 </refsection>
 </refentry>