Synopsis

<xsl:param name="man.string.subst.map">
  <substitution oldstring="\" newstring="\\"></substitution>
  <!-- * now, we need to restore single-backslashes in all roff -->
  <!-- * requests (because the substitution above doubled them) -->
  <substitution oldstring="\\fB" newstring="\fB"></substitution>
  <substitution oldstring="\\fI" newstring="\fI"></substitution>
  <substitution oldstring="\\fR" newstring="\fR"></substitution>
  <substitution oldstring="\\n" newstring="\n"></substitution>
  <!-- * requests in .SH sectsions output from Refsect1-level source -->
  <!-- * end up getting capitalized... -->
  <substitution oldstring="\\FB" newstring="\fB"></substitution>
  <substitution oldstring="\\FI" newstring="\fI"></substitution>
  <substitution oldstring="\\FR" newstring="\fR"></substitution>
  <substitution oldstring="\\%" newstring="\%"></substitution>
  <substitution oldstring="\\&" newstring="\&"></substitution>
  <substitution oldstring=".\\"" newstring=".\""></substitution>
  <!-- * although the groff docs do not make it clear, it appears that -->
  <!-- * the only way to get a non-breaking hyphen in roff is to put a -->
  <!-- * backslash in front of it; and, unfortunately, groff is not smart -->
  <!-- * about where it breaks things (for example, it'll break an -->
  <!-- * argument for a command across a line, if that argument contains -->
  <!-- * a dash/hyphen); so, we must globally change all hyphens to "\-" -->
  <substitution oldstring="-" newstring="\-"></substitution>
  <!-- * now, we need to restore single-hypens in all roff requests -->
  <!-- * (because the substitution above added backslashes before them) -->
  <substitution oldstring=".sp \-" newstring=".sp -"></substitution>
  <substitution oldstring=".it 1 an\-trap" newstring=".it 1 an-trap"></substitution>
  <substitution oldstring=".nr an\-no\-space\-flag 1" newstring=".nr an-no-space-flag 1"></substitution>
  <substitution oldstring=".nr an\-break\-flag 1" newstring=".nr an-break-flag 1"></substitution>
  <substitution oldstring=".ll \-" newstring=".ll -"></substitution>
  <!-- * squeeze multiple newlines before a roff request  -->
  <substitution oldstring="

." newstring="
."></substitution>
  <!-- * remove any .sp occurences that directly follow a .PP  -->
  <substitution oldstring=".PP
.sp" newstring=".PP"></substitution>
  <!-- * squeeze multiple newlines after start of no-fill (verbatim) env. -->
  <substitution oldstring=".nf

" newstring=".nf
"></substitution>
  <!-- * squeeze multiple newlines after REstoring margin -->
  <substitution oldstring=".RE

" newstring=".RE
"></substitution>
  <!-- * an apostrophe at the beginning of a line gets interpreted as a -->
  <!-- * roff request (groff(7) says it is "the non-breaking control -->
  <!-- * character"); so we must add backslash before any apostrophe -->
  <!-- * found at the start of a line -->
  <substitution oldstring="
'" newstring="
\'"></substitution>
  <!-- * -->
  <!-- * 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=" " newstring="\ "></substitution>
  <!-- * x2008 is a "punctuation space"; we must replace it here because, -->
  <!-- * for certain reasons, the stylesheets add it before and after -->
  <!-- * every Parameter in Funcprototype output -->
  <substitution oldstring=" " newstring=" "></substitution>
  <substitution oldstring="⌂" newstring="	"></substitution>
  <!-- * -->
  <!-- * Now deal with some other characters that are added by the -->
  <!-- * stylesheets during processing. -->
  <!-- * -->
  <!-- * bullet -->
  <substitution oldstring="•" newstring="\(bu"></substitution>
  <!-- * left double quote -->
  <substitution oldstring="“" newstring="\(lq"></substitution>
  <!-- * right double quote -->
  <substitution oldstring="”" newstring="\(rq"></substitution>
  <!-- * left single quote -->
  <substitution oldstring="‘" newstring="\(oq"></substitution>
  <!-- * right single quote -->
  <substitution oldstring="’" newstring="\(cq"></substitution>
  <!-- * copyright sign -->
  <substitution oldstring="©" newstring="\(co"></substitution>
  <!-- * registered sign -->
  <substitution oldstring="®" newstring="\(rg"></substitution>
  <!-- * servicemark... -->
  <!-- * There is no groff equivalent for it. -->
  <substitution oldstring="℠" newstring="(SM)"></substitution>
  <!-- * trademark... -->
  <!-- * We don't do "\(tm" because for console output, -->
  <!-- * groff just renders that as "tm"; that is: -->
  <!-- * -->
  <!-- *   Product&#x2122; -> Producttm -->
  <!-- * -->
  <!-- * So we just make it to "(TM)" instead; thus: -->
  <!-- * -->
  <!-- *   Product&#x2122; -> Product(TM) -->
  <substitution oldstring="™" newstring="(TM)"></substitution>
</xsl:param>