[docbook-tc] Re: [docbook-dev] validation issues for the docbook xml4.2 CR-1: unused parameters

[Bob Stayton <bobs@caldera.com>]

On Sat, Mar 30, 2002 at 07:31:49PM -0500, Adam Di Carlo wrote:
> 
> The docbook XML DTD, version 4.2 CR-1 causes the following validation
> warnings:
> 
>   /usr/bin/onsgmls -wxml -wall -gues test-4.2.xml
>   In entity book included from test-4.2.xml:3:49
>   /usr/bin/onsgmls:/usr/share/sgml/docbook/dtd/xml/4.2.cr1/docbookx.dtd:80:0:W: unused parameter entity "hh"
>   In entity book included from test-4.2.xml:3:49
>   In entity dbpool included from /usr/share/sgml/docbook/dtd/xml/4.2.cr1/docbookx.dtd:123:8
>   /usr/bin/onsgmls:/usr/share/sgml/docbook/dtd/xml/4.2.cr1/dbpoolx.mod:874:0:W: unused parameter entity "local.info.class"
>   In entity book included from test-4.2.xml:3:49
>   In entity dbpool included from /usr/share/sgml/docbook/dtd/xml/4.2.cr1/docbookx.dtd:123:8
>   In entity tablemodel included from /usr/share/sgml/docbook/dtd/xml/4.2.cr1/dbpoolx.mod:3527:12
>   /usr/bin/onsgmls:/usr/share/sgml/docbook/dtd/xml/4.2.cr1/calstblx.dtd:67:0:W: unused parameter entity "tbl.table.name"
>   In entity book included from test-4.2.xml:3:49
>   In entity dbpool included from /usr/share/sgml/docbook/dtd/xml/4.2.cr1/docbookx.dtd:123:8
>   /usr/bin/onsgmls:/usr/share/sgml/docbook/dtd/xml/4.2.cr1/dbpoolx.mod:399:0:W: unused parameter entity "ubiq.mix"
>   In entity book included from test-4.2.xml:3:49
>   In entity dbpool included from /usr/share/sgml/docbook/dtd/xml/4.2.cr1/docbookx.dtd:123:8
>   /usr/bin/onsgmls:/usr/share/sgml/docbook/dtd/xml/4.2.cr1/dbpoolx.mod:398:0:W: unused parameter entity "local.ubiq.mix"
> 
> I would suggest removing these unused parameter entities.  Or, in some
> cases, they should be used in the proper location.
> 
> I'd be happy to come up with a diff against the DTD which would
> suppress these issues, if requested.

I agree that the DTD should not generate these warnings.
It's hard enough getting everything right without the
DTD making noises like this.
Here is my input on these items.

hh
      The &ho; entity is used, but the &hh; entity is not.
      I think he probably added it in case it was needed,
      but it isn't used in either the SGML or XML DTDs.

local.info.class
      This should be in the info.class content model.  I
      think you found a bug.

tbl.table.name
      This is a CALS table compatibility issue that has some
      history that I'm not entirely familiar with.

ubiq.mix
local.ubiq.mix
      These two are used in the SGML version of the DTD in
      exclusions, which aren't part of the XML DTD.  They
      should be excluded entirely from the XML version
      in my opinion.  If you can figure out a way to 
      do that, that would be good.


-- 

Bob Stayton                                 400 Encinal Street
Publications Architect                      Santa Cruz, CA  95060
Technical Publications                      voice: (831) 427-7796
Caldera International, Inc.                 fax:   (831) 429-1887
                                            email: bobs@caldera.com