Re: [docbook-apps] Re: refentry, man(nroff), & comments in lists

[Bob Stayton <bobs@sco.com>]

On Fri, Nov 07, 2003 at 09:58:37PM -0500, Sam Steingold wrote:
> > * Bob Stayton <obof@fpb.pbz> [2003-11-07 10:08:26 -0800]:
> >
> >> 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.
> 
> you mean something like this?
> 
> cd d:/gnu/cygwin/usr/share/docbook-xsl/fo/
> diff -u -b -w -i -B "d:/gnu/cygwin/usr/share/docbook-xsl/fo/lists.xsl.old" "d:/gnu/cygwin/usr/share/docbook-xsl/fo/lists.xsl"
> --- d:/gnu/cygwin/usr/share/docbook-xsl/fo/lists.xsl.old	2003-10-03 03:22:22.001000000 -0400
> +++ d:/gnu/cygwin/usr/share/docbook-xsl/fo/lists.xsl	2003-11-07 21:55:53.485436800 -0500
> @@ -330,7 +330,7 @@
>                      "{$termlength}+{$label-separation}"
>                   provisional-label-separation="{$label-separation}"
>                   xsl:use-attribute-sets="list.block.spacing">
> -    <xsl:apply-templates select="varlistentry" mode="vl.as.list"/>
> +    <xsl:apply-templates mode="vl.as.list"/>
>    </fo:list-block>
>  </xsl:template>
> 
> 
> Diff finished at Fri Nov 07 21:55:54

Actually, I was looking at html/lists.xsl, because
manpages uses that template during processing.
 
> 
> why do the stylesheets do that at all - I mean, process only the list
> elements, not comments &c?!

Generally comments in the source don't contribute to
the HTML or print output, so they are not processed.

> One would have to go through all the stylesheets for all the backends...
> 
> Who is the templates maintainer?

Which templates are you referring to?

-- 

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