Swiftdiff options
| author | Remko Tronçon <git@el-tramo.be> | 2010-03-28 19:43:32 (GMT) |
|---|---|---|
| committer | Remko Tronçon <git@el-tramo.be> | 2010-03-28 19:44:49 (GMT) |
| commit | 3afa4f741c26360245dc313bc368f508b26a6b96 (patch) | |
| tree | 4fc9fedac990a099010fed8a4ee09ddc51c21cc5 /3rdParty/DocBook/XSL/params/man.output.encoding.xml | |
| parent | 7548dabae7d10e48816142e508be651ada9f7bc3 (diff) | |
| download | swift-contrib-3afa4f741c26360245dc313bc368f508b26a6b96.zip swift-contrib-3afa4f741c26360245dc313bc368f508b26a6b96.tar.bz2 | |
Added DocBook infrastructure.
Imported most of "DocBook kit".
Added placeholder for Swiften developers guide.
Diffstat (limited to '3rdParty/DocBook/XSL/params/man.output.encoding.xml')
| -rw-r--r-- | 3rdParty/DocBook/XSL/params/man.output.encoding.xml | 53 |
1 files changed, 53 insertions, 0 deletions
diff --git a/3rdParty/DocBook/XSL/params/man.output.encoding.xml b/3rdParty/DocBook/XSL/params/man.output.encoding.xml new file mode 100644 index 0000000..7154bc8 --- /dev/null +++ b/3rdParty/DocBook/XSL/params/man.output.encoding.xml @@ -0,0 +1,53 @@ +<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="man.output.encoding"> +<refmeta> +<refentrytitle>man.output.encoding</refentrytitle> +<refmiscinfo class="other" otherclass="datatype">string</refmiscinfo> +</refmeta> +<refnamediv> +<refname>man.output.encoding</refname> +<refpurpose>Encoding used for man-page output</refpurpose> +</refnamediv> + +<refsynopsisdiv> +<src:fragment xml:id="man.output.encoding.frag"> +<xsl:param name="man.output.encoding">UTF-8</xsl:param> +</src:fragment> +</refsynopsisdiv> + +<refsection><info><title>Description</title></info> + +<para>This parameter specifies the encoding to use for files generated +by the manpages stylesheet. Not all processors support specification +of this parameter.</para> + +<important> + <para>If the value of the <parameter>man.charmap.enabled</parameter> + parameter is non-zero (the default), keeping the + <parameter>man.output.encoding</parameter> parameter at its default + value (<literal>UTF-8</literal>) or setting it to + <literal>UTF-16</literal> <emphasis role="bold">does not cause your + man pages to be output in raw UTF-8 or UTF-16</emphasis> -- because + any Unicode characters for which matches are found in the enabled + character map will be replaced with roff escape sequences before the + final man-page files are generated.</para> + + <para>So if you want to generate "real" UTF-8 man pages, without any + character substitution being performed on your content, you need to + set <parameter>man.charmap.enabled</parameter> to zero (which will + completely disable character-map processing). </para> + + <para>You may also need to set + <parameter>man.charmap.enabled</parameter> to zero if you want to + output man pages in an encoding other than <literal>UTF-8</literal> + or <literal>UTF-16</literal>. Character-map processing is based on + Unicode character values and may not work with other output + encodings.</para> +</important> + +</refsection> +</refentry> |