Re: [Boost-docs] Boostbook DTD clash

Subject: Re: [Boost-docs] Boostbook DTD clash
From: Paul A. Bristow (pbristow_at_[hidden])
Date: 2008-11-27 12:24:18

> -----Original Message-----
> From: boost-docs-bounces_at_[hidden] [mailto:boost-docs-
> bounces_at_[hidden]] On Behalf Of John Maddock
> Sent: 27 November 2008 11:58
> To: boost.docs
> Subject: [Boost-docs] Boostbook DTD clash
> 
> I note that using Docbook 4.5 DTD I see:
> 
> file:///C%3A/download/open/xml/docbook-xml-4.5/dbpoolx.mod:7254: validity
> error
> : Redefinition of element code
> <!ELEMENT code %ho; (%cptr.char.mix;)*>
>                                        ^
> validity warning : Attribute id of element code: already defined
>  %common.attrib;
>                 ^
>         lang            CDATA           #IMPLIED
>         ^
> validity warning : Attribute last-revision of element code: already
defined
>  %code.role.attrib;
>                    ^
> role            CDATA           #IMPLIED
> ^
> 
> when building quickbook/boostbook docs, looks like the <code> element
> defined by the Boostbook DTD was introduced in Docbook-4.3 so the two
DTD's
> now clash.  Is there any way we can fix this? 

Ah yes - that explains it.

> Maybe we should just require
> Docbook-4.3 and later and remove the <code> definition from Boostbook?

Are you suggesting removing

<!ELEMENT code ANY>
<!ATTLIST code %boost.common.attrib;>

from bookbook.dtd

relying on this in Docbook 4.5

<!ENTITY % code.module "INCLUDE">
<![%code.module;[
<!ENTITY % local.code.attrib "">
<!ENTITY % code.role.attrib "%role.attrib;">

<!ENTITY % code.element "INCLUDE">
<![%code.element;[
<!--doc:An inline code fragment.-->
<!ELEMENT code %ho; (%cptr.char.mix;)*>
<!--end of code.element-->]]>

<!ENTITY % code.attlist "INCLUDE">
<![%code.attlist;[
<!ATTLIST code
                language	CDATA	#IMPLIED
                %common.attrib;
                %code.role.attrib;
                %local.code.attrib;
>
<!--end of code.attlist-->]]>
<!--end of code.module-->]]>

(and bump the revision number to 1.2?

   This DTD module is identified by the PUBLIC and SYSTEM identifiers:

   PUBLIC "-//Boost//DTD BoostBook XML V1.1//EN"
   SYSTEM "http://www.boost.org/tools/boostbook/dtd/1.1/boostbook.dtd"

   $Revision: 48202 $
   $Date: 2008-08-18 17:46:32 -0400 (Mon, 18 Aug 2008) $

Shall I try this?

Are there not going to be any side effects?  My understanding is not
sufficient to tell :-(

Paul

---
Paul A. Bristow
Prizet Farmhouse
Kendal, UK   LA8 8AB
[phone], mobile [phone]
pbristow_at_[hidden]