OLD | NEW |
| (Empty) |
1 <refentry xmlns="http://docbook.org/ns/docbook" | |
2 xmlns:xlink="http://www.w3.org/1999/xlink" | |
3 xmlns:xi="http://www.w3.org/2001/XInclude" | |
4 xmlns:src="http://nwalsh.com/xmlns/litprog/fragment" | |
5 xmlns:xsl="http://www.w3.org/1999/XSL/Transform" | |
6 version="5.0" xml:id="hyphenate.verbatim"> | |
7 <refmeta> | |
8 <refentrytitle>hyphenate.verbatim</refentrytitle> | |
9 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo> | |
10 </refmeta> | |
11 <refnamediv> | |
12 <refname>hyphenate.verbatim</refname> | |
13 <refpurpose>Should verbatim environments be hyphenated on space characters?</ref
purpose> | |
14 </refnamediv> | |
15 | |
16 <refsynopsisdiv> | |
17 <src:fragment xml:id="hyphenate.verbatim.frag"><xsl:param name="hyphenate.verbat
im" select="0"/></src:fragment> | |
18 </refsynopsisdiv> | |
19 | |
20 <refsection><info><title>Description</title></info> | |
21 | |
22 <para>If the lines of program listing are too long to fit into one | |
23 line it is quite common to split them at space and indicite by hook | |
24 arrow that code continues on the next line. You can turn on this | |
25 behaviour for <tag>programlisting</tag>, | |
26 <tag>screen</tag> and <tag>synopsis</tag> elements by | |
27 using this parameter.</para> | |
28 | |
29 <para>Note that you must also enable line wrapping for verbatim environments and | |
30 select appropriate hyphenation character (e.g. hook arrow). This can | |
31 be done using <parameter>monospace.verbatim.properties</parameter> | |
32 attribute set:</para> | |
33 | |
34 <programlisting><xsl:attribute-set name="monospace.verbatim.properties" | |
35 use-attribute-sets="verbatim.properties monospace.properties"
> | |
36 <xsl:attribute name="wrap-option">wrap</xsl:attribute> | |
37 <xsl:attribute name="hyphenation-character">&#x25BA;</xsl:attribu
te> | |
38 </xsl:attribute-set></programlisting> | |
39 | |
40 <para>For a list of arrows available in Unicode see <uri xlink:href="http://www.
unicode.org/charts/PDF/U2190.pdf">http://www.unicode.org/charts/PDF/U2190.pdf</u
ri> and <uri xlink:href="http://www.unicode.org/charts/PDF/U2900.pdf">http://www
.unicode.org/charts/PDF/U2900.pdf</uri> and make sure that | |
41 selected character is available in the font you are using for verbatim | |
42 environments.</para> | |
43 | |
44 </refsection> | |
45 </refentry> | |
OLD | NEW |