Clarify how relative paths are resolved.

diff --git a/xsl/params/bibliography.collection.xml b/xsl/params/bibliography.collection.xml
index ee49ddea4e9cea23a753f9b52d19ea7ab4f6d2c3..6b80ce3089722eaa6ec4ee4e5fdd3b7f03bb5021 100644 (file)
--- a/xsl/params/bibliography.collection.xml
+++ b/xsl/params/bibliography.collection.xml
@@ -97,6 +97,25 @@ bibliography entries in exactly the same way you do now.</para>
 customization layer or directly through your processor's interface) to
 point to your global bibliography.</para>
 
+<para>A relative path in the parameter is interpreted in one
+of two ways:</para>
+<orderedlist numeration="loweralpha">
+  <listitem>
+    <para>If your document contains no links to empty bibliographic elements,
+    then the path is relative to the file containing
+    the first <tag>bibliomixed</tag> element in the document.</para>
+  </listitem>
+  <listitem>
+    <para>If your document does contain links to empty bibliographic elements,
+    then the path is relative to the file containing
+    the first such link element in the document.</para>
+  </listitem>
+  </listitem>
+</orderedlist>
+<para>Once the collection file is opened by the first instance described
+above, it stays open for the current document
+and the relative path is not reinterpreted again.</para>
+
 <para>The stylesheets will format the bibliography in your document as if
 all of the entries referenced appeared there literally.</para>
 

diff --git a/xsl/params/glossary.collection.xml b/xsl/params/glossary.collection.xml
index 5d5f803012da8fa99949f97f1e672c61073ef1f2..9db037c63ee7c84f5f7396b3e73aa3d9cb09e0fa 100644 (file)
--- a/xsl/params/glossary.collection.xml
+++ b/xsl/params/glossary.collection.xml
@@ -202,6 +202,9 @@ of two ways:</para>
     <tag>firstterm</tag> in the document to be linked.</para>
   </listitem>
 </orderedlist>
+<para>Once the collection file is opened by the first instance described
+above, it stays open for the current document
+and the relative path is not reinterpreted again.</para>
 
 <para>The stylesheets will format the glossary in your document as if
 all of the entries implicilty referenced appeared there literally.</para>