This is the mail archive of the
docbook-apps@lists.oasis-open.org
mailing list .
Re: [docbook-apps] refentry, man(nroff), & comments in lists
- From: Bob Stayton <bobs at sco dot com>
- To: Sam Steingold <sds at gnu dot org>
- Cc: docbook-apps at lists dot oasis-open dot org
- Date: Fri, 7 Nov 2003 10:08:26 -0800
- Subject: Re: [docbook-apps] refentry, man(nroff), & comments in lists
- References: <uislxz290.fsf@gnu.org>
On Thu, Nov 06, 2003 at 03:11:07PM -0500, Sam Steingold wrote:
> 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><!--</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="' '"/>
> <xsl:with-param name="replacement" select="'--> <!--'"/>
> </xsl:call-template>
> </xsl:variable>
> <xsl:value-of select="normalize-space($content)"/>
> <xsl:text>--></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?
It is likely that the template for variablelist is
explicitly selecting its children to process rather than
just doing a general apply-templates. That selection
probably only includes elements, not other node types like
comment(). You need to find where it is selecting its
content and make sure comment() is included. It looks
like it might be in the template for variablelists in
html/lists.xsl.
--
Bob Stayton 400 Encinal Street
Publications Architect Santa Cruz, CA 95060
Technical Publications voice: (831) 427-7796
The SCO Group fax: (831) 429-1887
email: bobs@sco.com
To unsubscribe from this list, send a post to docbook-apps-unsubscribe@lists.oasis-open.org, or visit http://www.oasis-open.org/mlmanage/.