Processing title in revhistory?

Hello,

what is the expected processing of a revhistory element that
contains a title?

According to (my understanding of) TDG5, a revhistory can
have a title
either as standalone or inside an info element. In my
DocBook 5.0
namespaced document, the following construct:

<revhistory>
  <title>Change history</title>
  <revision>
    <revnumber>0.1</revnumber>
    <date>2007-10-01</date>
    <revdescription><para>Created initial
version.</para></revdescription>
  </revision>
</revhistory>

makes the DocBook XSL-NS stylesheets v1.73.2 emit the error
message
"title encountered in revhistory, but no template
matches." and also
generate invalid XSL-FO, so that the FO validation
complains:

[error] Element 'fo:block' cannot be a child of
'fo:table-body'. Only
'table-row', 'table-cell', 'marker' and change bar elements
are
permitted in this context.

The offending construct in the resulting XSL-FO file looks
like this:

<fo:table-body start-indent="0pt"
end-indent="0pt">
  <fo:table-row>
    <fo:table-cell
number-columns-spanned="3">
      <fo:block>Revision History</fo:block>
    </fo:table-cell>
  </fo:table-row>
  <fo:block
color="red">&lt;title&gt;Change
history&lt;/title&gt;</fo:block>
  <fo:table-row>
    <fo:table-cell>
      <fo:block>Revision 0.1</fo:block>
    </fo:table-cell>
  <!-- etc. -->

Conceptually, shouldn't a title element as a child of
revhistory
override the generation of the default table cell content
that says
"Revision history"?

Changing the DocBook source to read:

<revhistory>
  <info>
    <title>Change history</title>
  </info>
  <!-- etc. -->

gets rid of the error message from the stylesheets, but
there is no
positive effect in the result.

Would it be a good idea to have a template for
revhistory/title in the
stylesheet? If so, what should it generate? Maybe put the
whole
revhistory inside an fo:table-and-caption element, and then
emit an
fo:table-caption element for the title?

This time I checked the bugs  and also
the features, but didn't find
anything relevant.

--Jere

------------------------------------------------------------
---------
To unsubscribe, e-mail: docbook-apps-unsubscribelists.oasis-open.org
For additional commands, e-mail: docbook-apps-helplists.oasis-open.org

> -----Original Message-----
> From: Jere Käpyaho 
> 
> According to (my understanding of) TDG5, a revhistory
can have a title
> either as standalone or inside an info element. In my
DocBook 5.0
> namespaced document, the following construct:
> 
> <revhistory>
>   <title>Change history</title>
>   <revision>
>     <revnumber>0.1</revnumber>
>     <date>2007-10-01</date>
>     <revdescription><para>Created initial 
> version.</para></revdescription>
>   </revision>
> </revhistory>
> 
> makes the DocBook XSL-NS stylesheets v1.73.2 emit the
error message
> "title encountered in revhistory, but no template
matches." and also
> generate invalid XSL-FO, so that the FO validation
complains:
> 
> [error] Element 'fo:block' cannot be a child of
'fo:table-body'. Only
> 'table-row', 'table-cell', 'marker' and change bar
elements are
> permitted in this context.

> Would it be a good idea to have a template for
revhistory/title in the
> stylesheet? If so, what should it generate? Maybe put
the whole
> revhistory inside an fo:table-and-caption element, and
then emit an
> fo:table-caption element for the title?


Yes, I think there should be a template for
revhistory/title. I don't have
any strong opinions on what it should generate. But at the
very least, the
output should not be invalid. 

Can you please file a bug report on the SourceForge site so
this doesn't get
lost?

/MJ



------------------------------------------------------------
---------
To unsubscribe, e-mail: docbook-apps-unsubscribelists.oasis-open.org
For additional commands, e-mail: docbook-apps-helplists.oasis-open.org