This is the mail archive of the docbook-apps@lists.oasis-open.org mailing list .


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

[docbook-apps] Re: xsl-stylesheets/manpages


> * In message <20030514230922.GP1412@redhat.com>
> * On the subject of "Re: Re: xsl-stylesheets/manpages"
> * Sent on Thu, 15 May 2003 00:09:22 +0100
> * Honorable Tim Waugh <twaugh@redhat.com> writes:
>
> On Mon, May 12, 2003 at 04:10:37PM -0400, Sam Steingold wrote:
>
> > > Are you using '<sbr/>'?
> > no.  do you?  should I?  why did it insert one break but not the others?
> Actually now that I look at it, the current code ignores sbr
> altogether.
yuk.

> > > > refsection's are not marked as such
> > > Are for me.
> > in XHTML or groff?
>
> groff, but actually my XML uses refsect1s.  Looks like refsections
> aren't handled yet. :-(

double yuk.  did you report the bug?

> > 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.
>
> I don't see this in 1.61.0; also multiple terms seem to work for me as
> expected (separated by commas).

that's what I see with 1.61.0!
moreover, with 1.61.0, the synopsis looks like this:

       clisp [-h-h] [--help--help] [--version--version] [--license--license]
             [-B lisp-lib-dir-B lisp-lib-dir]
              [-K linking-set-K linking-set]
              [-M mem-file-M mem-file] [-m mem-size-m mem-size]
              [-s stack-size-s stack-size]

i.e., every option is printed twice!

<arg><option><link linkend="opt-help">-h</link></option></arg>
<arg><option><link linkend="opt-help">--help</link></option></arg>
<arg><option><link linkend="opt-version">--version</link></option></arg>
<arg><option><link linkend="opt-license">--license</link></option></arg>
<arg><option><link linkend="opt-libdir">-B
   <replaceable>lisp-lib-dir</replaceable></link></option></arg>


> > so how do I pass comments on into groff?
>
> With '.\"' I think.  A simplistic template would be:
>
> <xsl:template match="comment()">
>   <xsl:text>&#10;.\"</xsl:text><xsl:value-of select="."/>
>   <xsl:text>&#10;</xsl:text>
> </xsl:template>
>
> but that won't work for multiline comments.

how are groff comments marked? from '\n.\"' to '\n'?
no multiline comments?  triple yuk!

> Of course you can split them into lines in the template.

how?

--
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>
If you're passed on the right, you're in the wrong lane.


---------------------------------------------------------------------
To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]