OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

docbook-apps message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [Elist Home]

Subject: Re: DOCBOOK-APPS: <cmdsynopsis> output problem

Tom asks, "Does anybody know what could be causing this?" Not really, but I
can confirm it and expand a bit. The same behavior appertains in XML. In
the XSL (synop.xsl files in the html, fo, and manpage directories) , the
repeat calls a variable in common.xsl named arg.rep.repeat.str, which
apparently only gives an ellipsis if no text value is present for the arg
in question.

I'd call this a bug.

Dennis Grace

Information Developer
IBM Linux Technology Center
(512) 838-3937  T/L 678-3937  cell: (512)-296-7830

There are only 10 kinds of people in the world: those who understand binary
and those who don't.

                      Tom Olsen                                                                                                        
                      <olsen@lsil.com>         To:       docbook-apps@lists.oasis-open.org                                             
                      09/03/2002 04:48         Subject:  DOCBOOK-APPS: <cmdsynopsis> output problem                                    

Using DocBook SGML 4.1, the modular stylesheets, and docbook-to-man, I'm
having a problem producing the correct <cmdsynopsis> output in PDF and
What I need to produce is this:

{file ... | dir ...}

To make it appear OK in HTML and PDF, I have to use the following
"incorrect" markup:

    <arg choice="req" rep="repeat">
      <group choice="plain">
        <arg choice="plain"><replaceable>file</replaceable>
          <arg choice="plain" rep="repeat"></arg>
        <arg choice="plain"><replaceable>dir</replaceable></arg>

In short, I have to force the signifier for "repeatable" after file by
adding an element and attributes tag that shouldn't be there.

When using more "correct" markup (which happens to produce the desired
output in *roff), such as the following:

    <group choice="req">
      <arg choice="plain" rep="repeat">
      <arg choice="plain" rep="repeat">

I get the following output in PDF and HTML:

{file | dir}

Does anyone have any idea what could be causing this?

Any help is appreciated. Thank you in advance.

Tom Olsen
LSI Logic Storage Systems, Inc.

(See attached file: winmail.dat)

<<attachment: winmail.dat>>

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [Elist Home]

Powered by eList eXpress LLC