<refentry xmlns="http://docbook.org/ns/docbook"
          xmlns:xlink="http://www.w3.org/1999/xlink"
          xmlns:xi="http://www.w3.org/2001/XInclude"
          xmlns:src="http://nwalsh.com/xmlns/litprog/fragment"
          xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
          version="5.0" xml:id="ulink.hyphenate">
<refmeta>
<refentrytitle>ulink.hyphenate</refentrytitle>
<refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
</refmeta>
<refnamediv>
<refname>ulink.hyphenate</refname>
<refpurpose>Allow URLs to be automatically hyphenated</refpurpose>
</refnamediv>

<refsynopsisdiv>
<src:fragment xml:id="ulink.hyphenate.frag">
<xsl:param name="ulink.hyphenate"></xsl:param>
</src:fragment>
</refsynopsisdiv>

<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
in the <parameter>ulink.hyphenate.chars</parameter> parameter (default
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>

</refsection>
</refentry>
