Re: [Boost-docs] Boostbook DTD clash

Subject: Re: [Boost-docs] Boostbook DTD clash
From: Paul A. Bristow (pbristow_at_[hidden])
Date: 2008-12-02 10:12:49

> -----Original Message-----
> From: boost-docs-bounces_at_[hidden] [mailto:boost-docs-
> bounces_at_[hidden]] On Behalf Of Daniel James
> Sent: 27 November 2008 12:27
> To: Discussion of Boost Documentation
> Subject: Re: [Boost-docs] Boostbook DTD clash
> 
> 2008/11/27 John Maddock <john_at_[hidden]>:
> > I note that using Docbook 4.5 DTD I see:
> 
> >From the boostbook DTD:
> 
> <!--========== Import DocBook DTD ==========-->
> <!ENTITY % DocBook PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
>            "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
> 
> Which I believe means 'docbook 4.2' not 'docbook 4.2 or later'.
> 
> > Maybe we should just require
> > Docbook-4.3 and later and remove the <code> definition from Boostbook?
> 
> If someone with sufficient expertise wants to transition to a new
> version, that's probably fine. Although we'd have to leave the
> existing dtd in place.

I have tested out the proposal that entity Code be deleted from
boostbook.dtd,

Replacing the definition in boostbook.dtd
         
<!ELEMENT code ANY>
<!ATTLIST code %boost.common.attrib;>

Relying on the definition in Docbook DTD4.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-->]]>

At the end of boostbook.dtd I have changed the version from 4.2 to 4.5

<!--========== Import DocBook DTD - final version 4.5 ==========-->
<!ENTITY % DocBook PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
           "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">

But I am unclear what effect this has when my user-config.jam has the
version specified (and clearly uses this rather than the version 4.2
previously specified because the warnings appeared before I changed the line
above from 4.2 to 4.5:

using boostbook
   : "C:/Program Files/docbook/docbook-xsl-1.74.0" # Contains eXtended Style
Sheet programs.
   : "C:/Program Files/docbook/docbook-xml-4.5" # Contain DTD

This quiets the warning and I haven't seen any problems with the html and
pdf - yet.

But I would not claim to *really* know what I am doing here ;-))  So expert
comment very welcome.

What should I do now?

Paul

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