Re: xsl-stylesheets/manpages

[Sam Steingold <sds@gnu.org>]

> * In message <20030512190540.GY1412@redhat.com>
> * On the subject of "Re: xsl-stylesheets/manpages"
> * Sent on Mon, 12 May 2003 20:05:40 +0100
> * Honorable Tim Waugh <twaugh@redhat.com> writes:
>
> On Mon, May 12, 2003 at 01:58:51PM -0400, Sam Steingold wrote:
> 
> > what I get there is quite ugly:
> > cmdsynopsis has just one line break:
> 
> Are you using '<sbr/>'?

no.  do you?  should I?  why did it insert one break but not the others?

> > no TOC
> Er.. in a man page?
Er.. why not?

> > refsection's are not marked as such
> Are for me.

in XHTML or groff?
I get in XHTML but _not_ in groff.
More precisely, I see "NAME" (from refnamediv/refname) and "SYNOPSIS"
(from refsynopsisdiv), but not Description - from
<refsection id="description"><title>Description</title>
and not Options from
<refsection id="options"><title>Options</title>
&c &c

the other ugliness comes from this:

this:

<varlistentry id="opt-libdir"><term><option>-B</option> <replaceable>lisp-lib-dir</replaceable></term>
 <listitem><simpara>Specifies the installation directory.</simpara></listitem></varlistentry>

is formatted correctly like this:

       -B lisp-lib-dir
              Specifies the installation directory.

but XMLishly-equivalent

<varlistentry id="opt-libdir"><term><option>-B</option>
  <replaceable>lisp-lib-dir</replaceable></term>
 <listitem><simpara>Specifies the installation directory.
</simpara></listitem></varlistentry>

is mis-formatted as

      -B       lisp-lib-dir Specifies the installation directory.


also, several <term>s in one <varlistentry> (which lists the detailed
option description - what do you use for that?) are glued together:

<varlistentry id="opt-help"><term><option>-h</option></term>
 <term><option>--help</option></term>
 <listitem><simpara>Displays a help message on how to use &clisp;.
</simpara></listitem></varlistentry>

-->

       -h--help
              Displays a help message on how to use CLISP.

instead of


       -h
       --help
              Displays a help message on how to use CLISP.



> > I also need the comments to be passed on as comments.
> > I have
> > 
> > <xsl:template match="comment()">  <!-- pass though comments! -->
> >  <xsl:comment><xsl:value-of select="."/></xsl:comment>
> > </xsl:template>
> > 
> > and it does work with HTML but not groff.
> > [BTW, I would really like to have a NL before and after a comment...]
> 
> That could be useful; didn't think of that.

so how do I pass comments on into groff?

-- 
Sam Steingold (http://www.podval.org/~sds) running RedHat9 GNU/Linux
<http://www.camera.org> <http://www.iris.org.il> <http://www.memri.org/>
<http://www.mideasttruth.com/> <http://www.palestine-central.com/links.html>
Abandon all hope, all ye who press Enter.