<refentry xmlns:src="http://nwalsh.com/xmlns/litprog/fragment"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+ xmlns:ss="http://docbook.sf.net/xmlns/string.subst/1.0"
id="man.string.subst.map">
<refmeta>
<refentrytitle>man.string.subst.map</refentrytitle>
<!-- * because the groff docs say that's the correct thing to do; also -->
<!-- * because testing shows that "\\" doesn't always work as expected; -->
<!-- * for example, "\\" within a table seems to mess things up -->
- <substitution oldstring="\" newstring="\e"/>
+ <ss:substitution oldstring="\" newstring="\e"/>
<!-- * fix bad font-request capitalization in .SH (stylesheet artifact) -->
- <substitution oldstring="▓FB" newstring="\fB"/>
- <substitution oldstring="▓FI" newstring="\fI"/>
- <substitution oldstring="▓FR" newstring="\fR"/>
+ <ss:substitution oldstring="▓FB" newstring="\fB"/>
+ <ss:substitution oldstring="▓FI" newstring="\fI"/>
+ <ss:substitution oldstring="▓FR" newstring="\fR"/>
<!-- * remove no-break marker at beginning of line (stylesheet artifact) -->
- <substitution oldstring="▒▀" newstring="▒"/>
+ <ss:substitution oldstring="▒▀" newstring="▒"/>
<!-- * replace U+2580 no-break marker (stylesheet-added) w/ no-break space -->
- <substitution oldstring="▀" newstring="\ "/>
+ <ss:substitution oldstring="▀" newstring="\ "/>
<!-- * replace U+2593 marker with backslash -->
- <substitution oldstring="▓" newstring="\"/>
+ <ss:substitution oldstring="▓" newstring="\"/>
<!-- * escape dashes in content (only at line beginnings) -->
- <substitution oldstring=" ." newstring=" \&."/>
+ <ss:substitution oldstring=" ." newstring=" \&."/>
<!-- * replace U+2302 marker with dot -->
- <substitution oldstring="⌂" newstring="."/>
+ <ss:substitution oldstring="⌂" newstring="."/>
<!-- * escape dashes in content -->
- <substitution oldstring="-" newstring="\-"/>
+ <ss:substitution oldstring="-" newstring="\-"/>
<!-- * replace U+2591 marker with dash -->
- <substitution oldstring="░" newstring="-"/>
+ <ss:substitution oldstring="░" newstring="-"/>
<!-- ==================================================================== -->
<!-- * squeeze multiple newlines before a roff request -->
- <substitution oldstring=" ." newstring=" ."/>
+ <ss:substitution oldstring=" ." newstring=" ."/>
<!-- * remove any .sp occurences that directly follow a .PP -->
- <substitution oldstring=".PP .sp" newstring=".PP"/>
+ <ss:substitution oldstring=".PP .sp" newstring=".PP"/>
<!-- * squeeze multiple newlines after start of no-fill (verbatim) env. -->
- <substitution oldstring=".nf " newstring=".nf "/>
+ <ss:substitution oldstring=".nf " newstring=".nf "/>
<!-- * squeeze multiple newlines after REstoring margin -->
- <substitution oldstring=".RE " newstring=".RE "/>
+ <ss:substitution oldstring=".RE " newstring=".RE "/>
<!-- * 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=" \'"/>
+ <ss:substitution oldstring=" '" newstring=" \'"/>
<!-- * -->
<!-- * non-breaking space -->
<!-- * -->
<!-- * 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="\ "/>
+ <ss:substitution oldstring=" " newstring="\ "/>
<!-- * 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=" "/>
+ <ss:substitution oldstring=" " newstring=" "/>
<!-- * -->
<!-- * Now deal with some other characters that are added by the -->
<!-- * stylesheets during processing. -->
<!-- * -->
<!-- * bullet -->
- <substitution oldstring="•" newstring="\(bu"/>
+ <ss:substitution oldstring="•" newstring="\(bu"/>
<!-- * left double quote -->
- <substitution oldstring="“" newstring="\(lq"/>
+ <ss:substitution oldstring="“" newstring="\(lq"/>
<!-- * right double quote -->
- <substitution oldstring="”" newstring="\(rq"/>
+ <ss:substitution oldstring="”" newstring="\(rq"/>
<!-- * left single quote -->
- <substitution oldstring="‘" newstring="\(oq"/>
+ <ss:substitution oldstring="‘" newstring="\(oq"/>
<!-- * right single quote -->
- <substitution oldstring="’" newstring="\(cq"/>
+ <ss:substitution oldstring="’" newstring="\(cq"/>
<!-- * copyright sign -->
- <substitution oldstring="©" newstring="\(co"/>
+ <ss:substitution oldstring="©" newstring="\(co"/>
<!-- * registered sign -->
- <substitution oldstring="®" newstring="\(rg"/>
+ <ss:substitution oldstring="®" newstring="\(rg"/>
<!-- * servicemark... -->
<!-- * There is no groff equivalent for it. -->
- <substitution oldstring="℠" newstring="(SM)"/>
+ <ss:substitution oldstring="℠" newstring="(SM)"/>
<!-- * trademark... -->
<!-- * We don't do "\(tm" because for console output, -->
<!-- * groff just renders that as "tm"; that is: -->
<!-- * So we just make it to "(TM)" instead; thus: -->
<!-- * -->
<!-- * Product™ -> Product(TM) -->
- <substitution oldstring="™" newstring="(TM)"/>
+ <ss:substitution oldstring="™" newstring="(TM)"/>
<!-- ==================================================================== -->
<!-- * we use U+2592 as a marker for the newline before output of <sbr>; -->
<!-- * so we now need to replace U+2592 marker with a real newline -->
- <substitution oldstring="▒" newstring=" "/>
+ <ss:substitution oldstring="▒" newstring=" "/>
</xsl:param>
</src:fragment>
<title>Contents of the substitution map</title>
<para>The string-substitution map contains one or more <tag
namespace="http://docbook.sf.net/xmlns/string.subst/1.0"
- >substitution</tag> elements, each of which has two attributes:
+ >ss:substitution</tag> elements, each of which has two attributes:
<variablelist>
<varlistentry>
<term>oldstring</term>