111011T07:57

diff --git a/xsl/params/hyphenate.xml b/xsl/params/hyphenate.xml
index 46a2d614060f043e4e634ac52e7e26e90b958a49..aa6e129f4b8b695b8491f58ffeb381af064521ee 100644 (file)
--- a/xsl/params/hyphenate.xml
+++ b/xsl/params/hyphenate.xml
@@ -22,8 +22,8 @@
 
 <refsection><info><title>Description</title></info>
 
-<para>If true, words may be hyphenated. Otherwise, they may not.
-</para>
+<para>If true, words may be hyphenated. Otherwise, they may not.</para>
+<para>See also <parameter>ulink.hyphenate.chars</parameter> </para>
 
 </refsection>
 </refentry>

diff --git a/xsl/params/ulink.hyphenate.chars.xml b/xsl/params/ulink.hyphenate.chars.xml
index 7fdd771d75a8c6efb8694a37f52ed804b4fca783..7419e87ce480e0a399b5ee81c51c6aa86a289000 100644 (file)
--- a/xsl/params/ulink.hyphenate.chars.xml
+++ b/xsl/params/ulink.hyphenate.chars.xml
@@ -10,7 +10,8 @@
 </refmeta>
 <refnamediv>
 <refname>ulink.hyphenate.chars</refname>
-<refpurpose>List of characters to allow ulink URLs to be automatically hyphenated on</refpurpose>
+<refpurpose>List of characters to allow ulink URLs to be automatically
+hyphenated on</refpurpose>
 </refnamediv>
 
 <refsynopsisdiv>
@@ -21,14 +22,14 @@
 
 <refsection><info><title>Description</title></info>
 
-<para>If the <parameter>ulink.hyphenate</parameter> is not empty, then 
-hyphenation of ulinks is turned on, and any
-character contained in this parameter is treated as an allowable
-hyphenation point.</para>
+<para>If the <parameter>ulink.hyphenate</parameter> parameter is not
+empty, then hyphenation of ulinks is turned on, and any character
+contained in this parameter is treated as an allowable hyphenation
+point. This and <parameter>ulink.hyphenate</parameter> work together,
+one is pointless without the other being set to a non-empty value</para>
 
-<para>The default value is <quote>/</quote>, but the parameter
-could be customized
-to contain other URL characters, as for example:</para>
+<para>The default value is <quote>/</quote>, but the parameter could
+be customized to contain other URL characters, as for example:</para>
 <programlisting>
 &lt;xsl:param name="ulink.hyphenate.chars"&gt;:/@&amp;?.#&lt;/xsl:param&gt;
 </programlisting>

diff --git a/xsl/params/ulink.hyphenate.xml b/xsl/params/ulink.hyphenate.xml
index f80d465e379e05919f4ba3c0c7ad67c2689b57cd..8aa1dfed46fc0a09653648cde90e6229f229be1b 100644 (file)
--- a/xsl/params/ulink.hyphenate.xml
+++ b/xsl/params/ulink.hyphenate.xml
@@ -21,19 +21,19 @@
 
 <refsection><info><title>Description</title></info>
 
-<para>If not empty, the specified character (or more generally, content) is
-added to URLs after every character included in the string
+<para>If not empty, the specified character (or more generally,
+content) is added to URLs after every character included in the string
 in the <parameter>ulink.hyphenate.chars</parameter> parameter (default
-is <quote>/</quote>). If the character in this parameter is a
-Unicode soft hyphen (0x00AD) or Unicode zero-width space (0x200B), some FO
-processors will be able to reasonably hyphenate long URLs.</para>
+is <quote>/</quote>) to enable hyphenation of ulinks. If the character
+in this parameter is a Unicode soft hyphen (0x00AD) or Unicode
+zero-width space (0x200B), some FO processors will be able to
+reasonably hyphenate long URLs.</para>
 
-<para>Note that this hyphenation process is only applied when
-the ulink element is empty and the url attribute is reused as
-the link text.  It is not applied if the ulink has
-literal text content. The same applies in
-in DocBook 5, where ulink was replaced with
-link with an xlink:href attribute.</para>
+<para>Note that this hyphenation process is only applied when the
+ulink element is empty and the url attribute is reused as the link
+text.  It is not applied if the ulink has literal text content. The
+same applies in in DocBook 5, where ulink was replaced with link with
+an xlink:href attribute.</para>
 
 </refsection>
 </refentry>