This is the mail archive of the
docbook-apps@lists.oasis-open.org
mailing list .
[docbook-apps] Re: xsl-stylesheets/manpages
- From: Sam Steingold <sds at gnu dot org>
- To: docbook-apps at lists dot oasis-open dot org
- Date: 12 May 2003 16:10:37 -0400
- Subject: [docbook-apps] Re: xsl-stylesheets/manpages
- Organization: disorganization
- References: <m3y91cyrl0.fsf@loiso.podval.org> <20030512190540.GY1412@redhat.com>
- Reply-to: sds at gnu dot 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.
---------------------------------------------------------------------
To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org