+++ /dev/null
-<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="man.output.encoding">\r
-<refmeta>\r
-<refentrytitle>man.output.encoding</refentrytitle>\r
-<refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>\r
-</refmeta>\r
-<refnamediv>\r
-<refname>man.output.encoding</refname>\r
-<refpurpose>Encoding used for man-page output</refpurpose>\r
-</refnamediv>\r
-\r
-<refsynopsisdiv>\r
-<src:fragment xml:id="man.output.encoding.frag">\r
-<xsl:param name="man.output.encoding">UTF-8</xsl:param>\r
-</src:fragment>\r
-</refsynopsisdiv>\r
-\r
-<refsection><info><title>Description</title></info>\r
-\r
-<para>This parameter specifies the encoding to use for files generated\r
-by the manpages stylesheet. Not all processors support specification\r
-of this parameter.</para>\r
-\r
-<important>\r
- <para>If the value of the <parameter>man.charmap.enabled</parameter>\r
- parameter is non-zero (the default), keeping the\r
- <parameter>man.output.encoding</parameter> parameter at its default\r
- value (<literal>UTF-8</literal>) or setting it to\r
- <literal>UTF-16</literal> <emphasis role="bold">does not cause your\r
- man pages to be output in raw UTF-8 or UTF-16</emphasis> -- because\r
- any Unicode characters for which matches are found in the enabled\r
- character map will be replaced with roff escape sequences before the\r
- final man-page files are generated.</para>\r
-\r
- <para>So if you want to generate "real" UTF-8 man pages, without any\r
- character substitution being performed on your content, you need to\r
- set <parameter>man.charmap.enabled</parameter> to zero (which will\r
- completely disable character-map processing). </para>\r
-\r
- <para>You may also need to set\r
- <parameter>man.charmap.enabled</parameter> to zero if you want to\r
- output man pages in an encoding other than <literal>UTF-8</literal>\r
- or <literal>UTF-16</literal>. Character-map processing is based on\r
- Unicode character values and may not work with other output\r
- encodings.</para>\r
-</important>\r
-\r
-</refsection>\r
-</refentry>\r