Re: [docbook] Announce: DocBook V5.0CR5

["Hannes Magnusson" <hannes.magnusson@gmail.com>]

Hi Norman

On 7/19/07, Norman Walsh <ndw@nwalsh.com> wrote:
> A few days ago, I published (but apparently forgot to announce here)
> DocBook V5.0CR5:
>
>   http://docbook.org/xml/5.0CR5/
[snip]
>
> Test, please. Sooner rather than later :-)

While upgrading our project to DocBook5 we found a minor bug in the
XSD and DTD schemas;
refsect1 _must_ contain refsect2, and refsect2 _must_ contain refsect3

The attached patch fixed the issue for us :)

-Hannes
--- xsd/docbook-RC5.xsd	2007-07-12 16:37:05.000000000 +0200
+++ xsd/docbook.xsd	2007-08-15 20:46:54.000000000 +0200
@@ -11354,7 +11354,7 @@
               <xs:element ref="docbook:simpara"/>
               <xs:element ref="docbook:annotation"/>
             </xs:choice>
-            <xs:element maxOccurs="unbounded" ref="docbook:refsect2"/>
+            <xs:element minOccurs="0" maxOccurs="unbounded" ref="docbook:refsect2"/>
           </xs:sequence>
           <xs:element maxOccurs="unbounded" ref="docbook:refsect2"/>
         </xs:choice>
@@ -11436,7 +11436,7 @@
               <xs:element ref="docbook:simpara"/>
               <xs:element ref="docbook:annotation"/>
             </xs:choice>
-            <xs:element maxOccurs="unbounded" ref="docbook:refsect3"/>
+            <xs:element minOccurs="0" maxOccurs="unbounded" ref="docbook:refsect3"/>
           </xs:sequence>
           <xs:element maxOccurs="unbounded" ref="docbook:refsect3"/>
         </xs:choice>
--- dtd/docbook-RC5.dtd	2007-07-12 16:37:04.000000000 +0200
+++ dtd/docbook.dtd	2007-08-15 20:46:54.000000000 +0200
@@ -2852,7 +2852,7 @@
 
 >
 
-<!ELEMENT refsect1 (((title|titleabbrev|subtitle)*, info?), (((itemizedlist|orderedlist|procedure|simplelist|variablelist|segmentedlist|glosslist|bibliolist|calloutlist|qandaset|caution|important|note|tip|warning|example|figure|table|equation|informalexample|informalfigure|informaltable|informalequation|sidebar|blockquote|address|epigraph|mediaobject|screenshot|task|productionset|constraintdef|msgset|programlisting|screen|literallayout|synopsis|programlistingco|screenco|cmdsynopsis|funcsynopsis|classsynopsis|methodsynopsis|constructorsynopsis|destructorsynopsis|fieldsynopsis|bridgehead|remark|revhistory|indexterm|anchor|para|formalpara|simpara|annotation)+, (refsect2)+)|(refsect2)+))>
+<!ELEMENT refsect1 (((title|titleabbrev|subtitle)*, info?), (((itemizedlist|orderedlist|procedure|simplelist|variablelist|segmentedlist|glosslist|bibliolist|calloutlist|qandaset|caution|important|note|tip|warning|example|figure|table|equation|informalexample|informalfigure|informaltable|informalequation|sidebar|blockquote|address|epigraph|mediaobject|screenshot|task|productionset|constraintdef|msgset|programlisting|screen|literallayout|synopsis|programlistingco|screenco|cmdsynopsis|funcsynopsis|classsynopsis|methodsynopsis|constructorsynopsis|destructorsynopsis|fieldsynopsis|bridgehead|remark|revhistory|indexterm|anchor|para|formalpara|simpara|annotation)+, (refsect2)*)|(refsect2)*))>
 
 <!ATTLIST refsect1
 	xmlns	CDATA	#FIXED	"http://docbook.org/ns/docbook";
@@ -2864,7 +2864,7 @@
 
 >
 
-<!ELEMENT refsect2 (((title|titleabbrev|subtitle)*, info?), (((itemizedlist|orderedlist|procedure|simplelist|variablelist|segmentedlist|glosslist|bibliolist|calloutlist|qandaset|caution|important|note|tip|warning|example|figure|table|equation|informalexample|informalfigure|informaltable|informalequation|sidebar|blockquote|address|epigraph|mediaobject|screenshot|task|productionset|constraintdef|msgset|programlisting|screen|literallayout|synopsis|programlistingco|screenco|cmdsynopsis|funcsynopsis|classsynopsis|methodsynopsis|constructorsynopsis|destructorsynopsis|fieldsynopsis|bridgehead|remark|revhistory|indexterm|anchor|para|formalpara|simpara|annotation)+, (refsect3)+)|(refsect3)+))>
+<!ELEMENT refsect2 (((title|titleabbrev|subtitle)*, info?), (((itemizedlist|orderedlist|procedure|simplelist|variablelist|segmentedlist|glosslist|bibliolist|calloutlist|qandaset|caution|important|note|tip|warning|example|figure|table|equation|informalexample|informalfigure|informaltable|informalequation|sidebar|blockquote|address|epigraph|mediaobject|screenshot|task|productionset|constraintdef|msgset|programlisting|screen|literallayout|synopsis|programlistingco|screenco|cmdsynopsis|funcsynopsis|classsynopsis|methodsynopsis|constructorsynopsis|destructorsynopsis|fieldsynopsis|bridgehead|remark|revhistory|indexterm|anchor|para|formalpara|simpara|annotation)+, (refsect3)*)|(refsect3)*))>
 
 <!ATTLIST refsect2
 	xmlns	CDATA	#FIXED	"http://docbook.org/ns/docbook";