From: Dave Pawson <davep@dpawson.co.uk>
Date: Tue, 11 Oct 2011 07:57:59 +0000 (+0000)
Subject: 111011T07:57
X-Git-Tag: release/1.79.1~6^2~641
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=69f0f81822808de27dc89b94b2b787b2f6d17c3f;p=docbook-dsssl

111011T07:57
---

diff --git a/xsl/params/hyphenate.xml b/xsl/params/hyphenate.xml
index 46a2d6140..aa6e129f4 100644
--- 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 7fdd771d7..7419e87ce 100644
--- 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 f80d465e3..8aa1dfed4 100644
--- 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>