This is the mail archive of the docbook-apps@lists.oasis-open.org mailing list .


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

Re: [docbook-apps] DocBook Website 2.6.0 released


I objected to changing the version of the DTD when in fact the DTD had not
changed.  It is misleading, and forces people to validate their files to see
if they still work.  And to get them to validate, every webpage file's
DOCTYPE in a collection has to be updated for the new DTD version number.
Webpage sites can have hundreds of files.  If the DTD has not changed, that
is wasted busy work since it has no benefit.  Perhaps the next Website
release should go to 3.* and leave the DTDs behind, so that the version
numbers no longer have the appearance of being in synch.

Bob Stayton
Sagehill Enterprises
DocBook Consulting
bobs@sagehill.net


----- Original Message ----- 
From: "Oliver B. Fischer" <obf@gmx.de>
To: "Michael Smith" <smith@xml-doc.org>
Cc: <docbook-apps@lists.oasis-open.org>
Sent: Friday, April 29, 2005 4:37 PM
Subject: Re: [docbook-apps] DocBook Website 2.6.0 released


> Hello!
>
> It might be, that autolayout.dtd was not changed, but it could be
> confusing for some users, that website 2.6.0 used autolayout 2.5.0. I
> think it would be better that all files share the same version number.
> This is a much cleaner approach.
>
> Btw, the header of website.dtd is
>
>       <?xml version="1.0"?>
>       <!DOCTYPE webpage
>         PUBLIC "-//Norman Walsh//DTD Website V2.6//EN"
>
"http://docbook.sourceforge.net/release/website/2.6/schema/dtd/website.dtd";>
>
> but the files are under
> "http://docbook.sourceforge.net/release/website/2.6.0/schema/...
>
> Regards,
>
> Oliver Fischer
>
>
> Michael Smith wrote:
> > Oliver Fischer <obf@gmx.de> writes:
> >
> >
> >>1.) please check schema/dtd/autolayout.dtd
> >>
> >>There is written
> >> [...]
> >>
> >>     Please use the following formal public identifier to identify it:
> >>
> >>     "-//Norman Walsh//DTD Website Autolayout V2.5.0//EN"
> >>
> >>2.) xsl/autolayout.xsl contains:
> >>
> >><xsl:output method="xml" indent="no"
> >>            doctype-public="-//Norman Walsh//DTD Website Autolayout >
V2.5.0//EN"
> >>
>
>>doctype-system="http://docbook.sourceforge.net/release/website/2.5.0/schem
a/dtd/autolayout.dtd"
> >
> >
> > Is your concern that the 2.5.0 version number on autolayout.dtd
> > does not match the 2.6.0 version number for the release?
> >
> > The version number for autolayout.dtd was kept at 2.5.0
> > intentionally. We made a decision to not change version numbers on
> > the Website DTDs for this release (and for future releases)
> > unless/until there actually changes to them.
> >
> > There have been no changes to autolayout.dtd since the 2.5.0
> > release, so the version number was not changed.
> >
> > It is not necessary for the version numbers on autolayout.dtd and
> > layout.dtd to stay in sync with website.dtd and website-full.dtd.
> > The DTDs serve different purposes.
> >
> >   --Mike
> >
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
> For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org
>
>
>



---------------------------------------------------------------------
To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]