Re: defxx regression in docbook output cvs texinfo

[Per Bothner]

On 07/21/2012 02:19 AM, Patrice Dumas wrote:
> On Fri, Jul 20, 2012 at 08:59:57PM -0700, Per Bothner wrote:
> > This is a lot harder to deal with. There is no semantic information encoded
> > in the structure, just in the text.  Nothing to indicate that the word
> > "Procedure" has special meaning.  I.e. the translation has lost information.
> > Furthermore, getting rid of the colon is likely to be ugly,
>
> I agree with the diagnostic.
>
> What about dropping completly the colon?

I agree it would in principle be cleaner to drop the colon, and
instead have it be added by a stylesheet.  The problem is that
a generic DocBook processor or stylesheet won't know how to add
the colon, in which case the output will be weird.

http://www.docbook.org/tdg5/en/html/synopsis.html says:

  Description

  A synopsis is a verbatim environment for displaying command,
  function, and other syntax summaries.

  Unlike cmdsynopsis and funcsynopsis which have a complex interior
  structure, synopsis is simply a verbatim environment.

  Processing expectations

  This element is displayed “verbatim”; whitespace and line breaks
  within this element are significant. A synopsis element is usually
  displayed in a fixed-width font.

> Also I don't find a class
> attribute for phrase.  Shouldn't it be role instead?

I agree.  Updated patch attached.
--
        --Per Bothner
address@hidden   http://per.bothner.com/

db-synopsis.patch
Description: Text Data