Re: DOCBOOK-APPS: <cmdsynopsis> output problem

[Dennis Grace <dgrace at us dot ibm dot com>]

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
dgrace@us.ibm.com

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                                             
                                               cc:                                                                                     
                      09/03/2002 04:48         Subject:  DOCBOOK-APPS: <cmdsynopsis> output problem                                    
                      PM                                                                                                               
                                                                                                                                       
                                                                                                                                       



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
HTML.
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:

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

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:

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

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>>