doc/xslt/params/man.charmap.subset.profile.english.xml

   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="man.charmap.subset.profile.english">
   7 <refmeta>
   8 <refentrytitle>man.charmap.subset.profile.english</refentrytitle>
   9 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
  10 </refmeta>
  11 <refnamediv>
  12 <refname>man.charmap.subset.profile.english</refname>
  13 <refpurpose>Profile of character map subset</refpurpose>
  14 </refnamediv>
  15
  16 <refsynopsisdiv>
  17 <src:fragment xml:id="man.charmap.subset.profile.english.frag">
  18 <xsl:param name="man.charmap.subset.profile.english">
  19 @*[local-name() = 'block'] = 'Miscellaneous Technical' or
  20 (@*[local-name() = 'block'] = 'C1 Controls And Latin-1 Supplement (Latin-1 Supplement)' and
  21  @*[local-name() = 'class'] = 'symbols')
  22 or
  23 (@*[local-name() = 'block'] = 'General Punctuation' and
  24  (@*[local-name() = 'class'] = 'spaces' or
  25   @*[local-name() = 'class'] = 'dashes' or
  26   @*[local-name() = 'class'] = 'quotes' or
  27   @*[local-name() = 'class'] = 'bullets'
  28  )
  29 ) or
  30 @*[local-name() = 'name'] = 'HORIZONTAL ELLIPSIS' or
  31 @*[local-name() = 'name'] = 'WORD JOINER' or
  32 @*[local-name() = 'name'] = 'SERVICE MARK' or
  33 @*[local-name() = 'name'] = 'TRADE MARK SIGN' or
  34 @*[local-name() = 'name'] = 'ZERO WIDTH NO-BREAK SPACE'
  35 </xsl:param>
  36 </src:fragment>
  37 </refsynopsisdiv>
  38
  39 <refsection><info><title>Description</title></info>
  40
  41 <para>If the value of the
  42   <parameter>man.charmap.use.subset</parameter> parameter is
  43   non-zero, and your DocBook source is written in English (that
  44   is, if its <tag class="attribute">lang</tag> or <tag
  45     class="attribute">xml:lang</tag> attribute on the root element
  46   in your DocBook source or on the first <tag>refentry</tag>
  47   element in your source has the value <literal>en</literal> or if
  48   it has no <tag class="attribute">lang</tag> or <tag
  49     class="attribute">xml:lang</tag> attribute), then the
  50   character-map subset specified by the
  51   <parameter>man.charmap.subset.profile.english</parameter>
  52   parameter is used instead of the full roff character map.</para>
  53
  54 <para>Otherwise, if the <tag class="attribute">lang</tag> or <tag
  55     class="attribute">xml:lang</tag> attribute
  56   on the root element in your DocBook source or on the first
  57   <tag>refentry</tag> element in your source has a value other
  58   than <literal>en</literal>, then the character-map subset
  59   specified by the
  60   <parameter>man.charmap.subset.profile</parameter> parameter is
  61   used instead of
  62   <parameter>man.charmap.subset.profile.english</parameter>.</para>
  63
  64 <para>The difference between the two subsets is that
  65   <parameter>man.charmap.subset.profile</parameter> provides
  66   mappings for characters in Western European languages that are
  67   not part of the Roman (English) alphabet (ASCII character set).</para>
  68
  69 <para>The value of <parameter>man.charmap.subset.profile.english</parameter>
  70 is a string representing an XPath expression that matches attribute
  71 names and values for <tag
  72   namespace="http://docbook.sf.net/xmlns/unichar/1.0"
  73   >output-character</tag> elements in the character map.</para>
  74
  75 <para>For other details, see the documentation for the
  76 <parameter>man.charmap.subset.profile.english</parameter> and
  77 <parameter>man.charmap.use.subset</parameter> parameters.</para>
  78
  79 </refsection>
  80 </refentry>