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

 


Help: OASIS Mailing Lists Help | MarkMail Help

docbook message

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


Subject: Re: [docbook] upgrade 4.5 => 5.0 failed (on rather basic example)



Monday 21 December 2009
> 
> I'm upgrading a 4.5 Docbook document to 5.0 using db-upgrade.xsl and
> I'm getting an error on a rather simple document. Here it comes ..
> 
> <?xml version=3D"1.0" encoding=3D"UTF-8"?>
> <!DOCTYPE article
> PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
> "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd";>
> <article lang=3D"">
>  <sect1>
>    <title>Hello, ..</title>
>    <para>world</para>
>  </sect1>
> </article>
> 
> This document is valid according to a) Emacs/nxml and b) MSV.

I validated your document in oXygen and I can confirm it is valid. According 
to the content model of article[1], a title is _optional_.

 
> Then I upgraded this document with db4-upgrade.xsl  (Release: $Id:
> db4-upgrade.xsl 7660 2008-02-06 13:48:36Z nwalsh $) and I get:
> 
> <!-- Converted by db4-upgrade version 1.0 -->
> 
> <article xmlns=3D"http://docbook.org/ns/docbook"; version=3D"5.0"
>  xml:lang=""> <section><info><title>Hello, ..</title></info>
> 
>    <para>world</para>
>  </section>
> </article>
> 
> which is !!! NOT !!!  valid ( inserting a article/title element makes it
>  valid).

When I validate your file in oXygen, I get:

 element "section" not allowed yet; expected element "info", "subtitle", 
"title" or "titleabbrev"

So the best is to insert the missing title element right after article 
_before_ applying the transformation.

According to the RELAX NG schema, an article[2] needs a title. The stylesheet 
just doesn't know this case which creates an invalid DocBook 5 document. I 
would consider it a bug.

 
>Is this bug known?

Look at [3], maybe there is already one.


>Is there a bug tracker?

See [3] on Sourceforge.


>Patches accepted?

Probably yes. :)



Tom


----------
[1] http://www.docbook.org/tdg/en/html/article.html
[2] http://www.docbook.org/tdg5/en/html/article.html
[3] http://sourceforge.net/tracker/?group_id=21935&atid=373747


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