From: Mauritz Jeanson <mj@johanneberg.com>
Date: Sat, 1 Sep 2007 12:54:24 +0000 (+0000)
Subject: Updated description of img.src.path. Bug #1785224 revealed that
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=5f7deb822caff61c5717e50f4bd8cf46cd7b18ae;p=docbook-dsssl

Updated description of img.src.path. Bug #1785224 revealed that
there was a risk of misunderstanding how it works.
---

diff --git a/xsl/params/img.src.path.xml b/xsl/params/img.src.path.xml
index c5368b612..a4ff538d1 100644
--- a/xsl/params/img.src.path.xml
+++ b/xsl/params/img.src.path.xml
@@ -19,15 +19,19 @@
 
 <refsection><info><title>Description</title></info>
 
-<para>Add a path prefix to each HTML
-<tag class="element">img</tag> or FO 
-<tag class="element">fo:external-graphic</tag> element's
-<tag class="attribute">src</tag> attribute.
-This path could be relative to the directory where the HTML/FO
+<para>Add a path prefix to the value of the <tag class="attribute">fileref</tag> 
+attribute of <tag>graphic</tag> and <tag>imagedata</tag> elements. The resulting 
+compound path is used in the output as the value of the <tag class="attribute">src</tag> 
+attribute of <tag class="element">img</tag> (HTML) or <tag class="element">external-graphic</tag> (FO).
+</para>
+
+<para>
+The path given by <literal>img.src.path</literal> could be relative to the directory where the HTML/FO
 files are created, or it could be an absolute URI.
 The default value is empty.
 Be sure to include a trailing slash if needed.
 </para>
+
 <para>This prefix is not applied to any filerefs that start
 with "/" or contain "//:".
 </para>