refentry, man(nroff), & comments in lists

[Sam Steingold <sds@gnu.org>]

Hi, I am still having the problem that I cannot make xsltproc always
pass comments from docbook sources to the nroff output.

my stylesheet is:

<!-- here we just convert comments into < ! - - ... - - >
  for further processing with sed(1) (see Makefile) -->
<xsl:template match="comment()">
 <xsl:text>&#60;!--</xsl:text> <!-- #\< ! - - -->
 <xsl:variable name="content">
  <xsl:call-template name="string.subst">
   <xsl:with-param name="string"><xsl:value-of select="."/></xsl:with-param>
   <xsl:with-param name="target" select="'&#10;'"/>
   <xsl:with-param name="replacement" select="'--&#62;&#10;&#60;!--'"/>
  </xsl:call-template>
 </xsl:variable>
 <xsl:value-of select="normalize-space($content)"/>
 <xsl:text>--&#62;</xsl:text> <!-- - - #\> -->
</xsl:template>

document snippet:

<refsection id="environment"><title>Environment</title>
<variablelist>

<!-- #ifdef MSDOS -->
<varlistentry><term><envar>COMSPEC</envar> (OS/2 implementation only)</term>
 <listitem><simpara>is used to find the command interpreter called by
   <ulink url="impnotes.html#shell"><function>shell</function></ulink>.
</simpara></listitem></varlistentry>
<!-- #endif -->

...

</variablelist>
</refsection>

this is converted to

.TP
\fBCOMSPEC\fR (OS/2 implementation only)
is used to find the command interpreter called by \fBshell\fR\&.

the above stylesheet works fine for comments embedded in a <para>, but
not for lists.

is it possible to fix this bug?

-- 
Sam Steingold (http://www.podval.org/~sds) running w2k
<http://www.camera.org> <http://www.iris.org.il> <http://www.memri.org/>
<http://www.mideasttruth.com/> <http://www.honestreporting.com>
Please wait, MS Windows are preparing the blue screen of death.