From e8568f978e276aa8502ff0415ed95e4fdea0ccbd Mon Sep 17 00:00:00 2001
From: Michael Smith <xmldoc@users.sourceforge.net>
Date: Tue, 5 Jul 2005 03:49:25 +0000
Subject: [PATCH] Added the following substitutions:

  <!-- * non-breaking space
  <substitution oldstring="&#x00a0;" newstring="\ "/>
  <!-- * copyright sign
  <substitution oldstring="&#x00a9;" newstring="\(co"/>
  <!-- * registered sign
  <substitution oldstring="&#x00ae;" newstring="\(rg"/>
  <!-- * left double quote
  <substitution oldstring="&#x201c;" newstring="\(lq"/>
  <!-- * right double quote
  <substitution oldstring="&#x201d;" newstring="\(rq"/>
  <!-- * left single quote
  <substitution oldstring="&#x2018;" newstring="\(oq"/>
  <!-- * right single quote
  <substitution oldstring="&#x2019;" newstring="\(cq"/>

The reason is that those are all characters that the DocBook XSL
stylesheets themselves generate under certain circumstances; so
dealing with them in man.string.subst.map ensures they will always
be replaced, even if man.charmap.enabled is zero.
---
 xsl/params/man.string.subst.map.xml | 32 +++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)

diff --git a/xsl/params/man.string.subst.map.xml b/xsl/params/man.string.subst.map.xml
index d73dfa070..7aa38203d 100644
--- a/xsl/params/man.string.subst.map.xml
+++ b/xsl/params/man.string.subst.map.xml
@@ -35,6 +35,27 @@
   <!-- * character"); so we must add backslash before any apostrophe -->
   <!-- * found at the start of a line -->
   <substitution oldstring="&#10;'" newstring="&#10;\'"/>
+  <!-- * -->
+  <!-- * The remaining characters are all characters that the DocBook -->
+  <!-- * XSL stylesheets themselves generate under certain -->
+  <!-- * circumstances; so we deal with them here so that we can -->
+  <!-- * ensure they will always be replaced, even if -->
+  <!-- * man.charmap.enabled is zero. -->
+  <!-- * -->
+  <!-- * non-breaking space -->
+  <substitution oldstring="&#x00a0;" newstring="\ "/>
+  <!-- * copyright sign -->
+  <substitution oldstring="&#x00a9;" newstring="\(co"/>
+  <!-- * registered sign -->
+  <substitution oldstring="&#x00ae;" newstring="\(rg"/>
+  <!-- * left double quote -->
+  <substitution oldstring="&#x201c;" newstring="\(lq"/>
+  <!-- * right double quote -->
+  <substitution oldstring="&#x201d;" newstring="\(rq"/>
+  <!-- * left single quote -->
+  <substitution oldstring="&#x2018;" newstring="\(oq"/>
+  <!-- * right single quote -->
+  <substitution oldstring="&#x2019;" newstring="\(cq"/>
 </xsl:param>
 </src:fragment>
 </refsynopsisdiv>
@@ -49,6 +70,17 @@ man-page files to disk) or, if the value of the
 <parameter>man.charmap.enabled</parameter> parameter is non-zero,
 before applying the roff character map.</para>
 
+<para>You can use <parameter>man.string.subst.map</parameter> as a
+"lightweight" character map to perform "essential" substitutions --
+that is, substitutions that are <emphasis>always</emphasis> performed,
+even if the value of the <parameter>man.charmap.enabled</parameter>
+parameter is zero. For example, you can use it to replace quotation
+marks or other special characters that are generated by the DocBook
+XSL stylesheets for a particular locale setting (as opposed to those
+characters that are actually in source XML documents), or to replace
+any special characters that may be automatically generated by a
+particular customization of the DocBook XSL stylesheets.</para>
+
 <warning>
   <para>Do you not change value of the
   <parameter>man.string.subst.map</parameter> parameter unless
-- 
2.40.0