-<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="highlight.source">
-<refmeta>
-<refentrytitle>highlight.source</refentrytitle>
-<refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
-</refmeta>
-<refnamediv>
-<refname>highlight.source</refname>
-<refpurpose>Should the content of <tag>programlisting</tag>
-be syntactically highlighted?</refpurpose>
-</refnamediv>
-
-<refsynopsisdiv>
-<src:fragment xml:id="highlight.source.frag">
-<xsl:param name="highlight.source" select="0"/>
-</src:fragment>
-</refsynopsisdiv>
-
-<refsection><info><title>Description</title></info>
-
-<para>When this parameter is non-zero, the stylesheets will try to do
-syntax highlighting of the content of the <tag>programlisting</tag> element. The highlighting is done by the
-XSLTHL extension module. This is an external Java library which is not part of the DocBook XSL distribution.</para>
-
-<para>In order to use this extension, you must add
-<filename>xslthl-2.0.0.jar</filename> to your Java classpath. You can
-download this software from <link xlink:href="http://sourceforge.net/projects/xslthl">the XSLT syntax highlighting project</link> at SourceForge.</para>
-
-<para>The configuration of syntax highlighting is stored in
-<filename>highlighting/xslthl-config.xml</filename>. The Java
-property <literal>xslthl.config</literal> or parameter <parameter>highlight.xslthl.config</parameter> must point to this
-file (using URL syntax).</para>
-
-<para>This extension is known to work with Saxon 6.5.x, Saxon 8.5+ and Xalan-J. Here is an example of a modified Saxon command:</para>
-
-<programlisting>java -cp c:\batch\;…;c:\path\to\xslthl-2.0.0.jar -Dxslthl.config=file:///c:/docbook-xsl/highlighting/xslthl-config.xml … com.icl.saxon.StyleSheet …</programlisting>
-
-<para>You can specify the language for each programlisting by using the <tag class="attribute">language</tag> attribute. The
-<parameter>highlight.default.language</parameter> parameter can be used for specifying the
-language to be used for programlistings without a <tag class="attribute">language</tag> attribute.</para>
-
-</refsection>
-</refentry>
+<refentry xmlns="http://docbook.org/ns/docbook"\r
+ xmlns:xlink="http://www.w3.org/1999/xlink"\r
+ xmlns:xi="http://www.w3.org/2001/XInclude"\r
+ xmlns:src="http://nwalsh.com/xmlns/litprog/fragment"\r
+ xmlns:xsl="http://www.w3.org/1999/XSL/Transform"\r
+ version="5.0" xml:id="highlight.source">\r
+<refmeta>\r
+<refentrytitle>highlight.source</refentrytitle>\r
+<refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
+</refmeta>\r
+<refnamediv>\r
+<refname>highlight.source</refname>\r
+<refpurpose>Should the content of <tag>programlisting</tag>\r
+be syntactically highlighted?</refpurpose>\r
+</refnamediv>\r
+\r
+<refsynopsisdiv>\r
+<src:fragment xml:id="highlight.source.frag">\r
+<xsl:param name="highlight.source" select="0"/>\r
+</src:fragment>\r
+</refsynopsisdiv>\r
+\r
+<refsection><info><title>Description</title></info>\r
+\r
+<para>When this parameter is non-zero, the stylesheets will try to do syntax highlighting of the \r
+content of <tag>programlisting</tag> elements. You specify the language for each programlisting \r
+by using the <tag class="attribute">language</tag> attribute. The <parameter>highlight.default.language</parameter> \r
+parameter can be used to specify the language for programlistings without a <tag class="attribute">language</tag> \r
+attribute. Syntax highlighting also works for <tag>screen</tag> and <tag>synopsis</tag> elements.</para>\r
+\r
+<para>The actual highlighting work is done by the XSLTHL extension module. This is an external Java library that has to be \r
+downloaded separately (see below).</para>\r
+\r
+<itemizedlist>\r
+<para>In order to use this extension, you must</para> \r
+\r
+<listitem><para>add <filename>xslthl-2.x.x.jar</filename> to your Java classpath. The latest version is available\r
+from <link xlink:href="http://sourceforge.net/projects/xslthl">the XSLT syntax highlighting project</link> \r
+at SourceForge.</para>\r
+</listitem>\r
+<listitem>\r
+<para>use a customization layer in which you import two stylesheet modules: \r
+<orderedlist>\r
+ <listitem>\r
+ <para><filename>highlighting/common.xsl</filename>\r
+ </para>\r
+ </listitem>\r
+ <listitem><para>one of the following: \r
+ <filename>html/highlight.xsl</filename>, <filename>xhtml/highlight.xsl</filename>,\r
+ <filename>xhtml-1_1/highlight.xsl</filename>, <filename>fo/highlight.xsl</filename>.</para>\r
+</listitem>\r
+</orderedlist>\r
+\r
+</para>\r
+</listitem>\r
+<listitem><para>let either the <literal>xslthl.config</literal> Java system property or the\r
+<parameter>highlight.xslthl.config</parameter> parameter point to the configuration file for syntax \r
+highlighting (using URL syntax). DocBook XSL comes with a ready-to-use configuration file, \r
+<filename>highlighting/xslthl-config.xml</filename>.</para>\r
+</listitem>\r
+</itemizedlist>\r
+\r
+<para>The extension works with Saxon 6.5.x and Xalan-J. (Saxon 8.5 or later is also supported, but since it is \r
+an XSLT 2.0 processor it is not guaranteed to work with DocBook XSL in all circumstances.)</para>\r
+\r
+<para>The following is an example of a Saxon 6 command adapted for syntax highlighting, to be used on Windows:</para>\r
+\r
+<informalexample>\r
+<para><command>java -cp c:/Java/saxon.jar;c:/Java/xslthl-2.0.1.jar \r
+-Dxslthl.config=file:///c:/docbook-xsl/highlighting/xslthl-config.xml com.icl.saxon.StyleSheet \r
+-o test.html test.xml myhtml.xsl</command></para>\r
+</informalexample>\r
+\r
+</refsection>\r
+</refentry>\r