From 5add101c799cbd4d6db8d0fb40424efaad5b1d3c Mon Sep 17 00:00:00 2001
From: Michael Smith <xmldoc@users.sourceforge.net>
Date: Mon, 11 Jul 2005 07:45:50 +0000
Subject: [PATCH] Added comment about non-breaking space.

---
 xsl/params/man.string.subst.map.xml | 25 +++++++++++++++++--------
 1 file changed, 17 insertions(+), 8 deletions(-)

diff --git a/xsl/params/man.string.subst.map.xml b/xsl/params/man.string.subst.map.xml
index 746ab7861..5ab05aef7 100644
--- a/xsl/params/man.string.subst.map.xml
+++ b/xsl/params/man.string.subst.map.xml
@@ -36,13 +36,22 @@
   <!-- * found at the start of a line -->
   <substitution oldstring="&#10;'" newstring="&#10;\'"/>
   <!-- * -->
-  <!-- * The remaining characters are all characters that the -->
-  <!-- * DpcBook 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 -->
+  <!-- * -->
+  <!-- * A no-break space can be written two ways in roff; the difference, -->
+  <!-- * according to the "Page Motions" node in the groff info page, ixsl: -->
+  <!-- * -->
+  <!-- *   "\ " = -->
+  <!-- *   An unbreakable and unpaddable (i.e. not expanded during filling) -->
+  <!-- *   space. -->
+  <!-- * -->
+  <!-- *   "\~" = -->
+  <!-- *   An unbreakable space that stretches like a normal -->
+  <!-- *   inter-word space when a line is adjusted."  -->
+  <!-- * -->
+  <!-- * Unfortunately, roff seems to do some weird things with long -->
+  <!-- * lines that only have words separated by "\~" spaces, so it's -->
+  <!-- * safer just to stick with the "\ " space -->
   <substitution oldstring="&#x00a0;" newstring="\ "/>
   <!-- * left double quote -->
   <substitution oldstring="&#x201c;" newstring="\(lq"/>
@@ -63,11 +72,11 @@
   <!-- * we don't do "\(tm" because for console output -->
   <!-- * because groff just renders that as "tm"; that is: -->
   <!-- * -->
-  <!-- *  Product&#x2122; -> Producttm -->
+  <!-- *   Product&#x2122; -> Producttm -->
   <!-- * -->
   <!-- * So we just make it to "(TM)" instead; thus: -->
   <!-- * -->
-  <!-- *  Product&#x2122; -> Product(TM) -->
+  <!-- *   Product&#x2122; -> Product(TM) -->
   <substitution oldstring="&#x2122;" newstring="(TM)"/>
 </xsl:param>
 </src:fragment>
-- 
2.40.0