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"
> 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
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">
<!ENTITY % local.code.attrib "">
<!ENTITY % code.role.attrib "%role.attrib;">
<!ENTITY % code.element "INCLUDE">
<!--doc:An inline code fragment.-->
<!ELEMENT code %ho; (%cptr.char.mix;)*>
<!--end of code.element-->]]>
<!ENTITY % code.attlist "INCLUDE">
language CDATA #IMPLIED
<!--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"
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:
: "C:/Program Files/docbook/docbook-xsl-1.74.0" # Contains eXtended Style
: "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 A. Bristow Prizet Farmhouse Kendal, UK LA8 8AB +44 1539 561830, mobile +44 7714330204 pbristow_at_[hidden]
This archive was generated by hypermail 2.1.7 : 2017-11-11 08:50:40 UTC