--- /dev/null
+<refentry id="ulink.hyphenate.chars">
+<refmeta>
+<refentrytitle>ulink.hyphenate.chars</refentrytitle>
+<refmiscinfo role="type">string</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>ulink.hyphenate.chars</refname>
+<refpurpose>List of characters to allow ulink URLs to be automatically hyphenated on</refpurpose>
+</refnamediv>
+
+<refsynopsisdiv>
+<src:fragment id='ulink.hyphenate.chars.frag'>
+<xsl:param name="ulink.hyphenate.chars" select="'/'"/>
+</src:fragment>
+</refsynopsisdiv>
+
+<refsect1><title>Description</title>
+
+<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>The default value is <quote>/<quote>, but the parameter
+could be customized
+to contain other URL characters, as for example:</para>
+<programlisting>
+<xsl:param name="ulink.hyphenate.chars">:/@&?.#</xsl:param>
+</programlisting>
+
+</refsect1>
+</refentry>
<refsect1><title>Description</title>
<para>If not empty, the specified character (or more generally, content) is
-added to URLs after every <quote>/</quote>. If the character specified is a
+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>