bug in WebCGM 2.0 DTD

[Lofton Henderson <lofton@rockynet.com>]

Hi WebCGM TC,

This is a heads-up message.  It is for your information purposes only.  It 
is not intended to be the formal first step in processing an erratum.  We 
are just sorting out the details of those steps [1].  We will soon begin 
the OASIS errata process.

[1] http://www.oasis-open.org/committees/process.php#3.5

Bug summary:
----------

The specific version of the DTD file [2] of the WebCGM 2.0 OASIS Standard 
(OS) [3] that was published on 2007-01-30 contains three interrelated 
editorial errors (see "Bug details" below).

[2] http://docs.oasis-open.org/webcgm/v2.0/OS/webcgm20.dtd
[3] http://docs.oasis-open.org/webcgm/v2.0/OS/webcgm-v2.0-index.html

That specific version [2] is presently referenced by a symlink from the URI 
[4], which URI corresponds to the System Identifier (SI) of the WebCGM 2.0 
XCF, as documented in the specification [5].  The URI [4] is viewed as the 
"latest version" URI for the DTD.

[4] http://docs.oasis-open.org/webcgm/v2.0/webcgm20.dtd
[5] http://docs.oasis-open.org/webcgm/v2.0/OS/WebCGM20-XCF.html#namespace

Bug details:
----------

E1.) Error: line 92, after "desc CDATA #IMPLIED" there is a stray ">". 
Correction: delete stray ">".
E2.) Error: line 93, the string "%linkuriAttExt;" has "Ext" capitalized 
instead of "EXT" upper case. Correction: change "Ext" to "EXT".
E3.) Error: line 43, the entity definition of "linkuriEXT" is "" instead of 
EMPTY. Correction: change "" to EMPTY.

In the text of the WebCGM 2.0 OS [6], the glitches E1 and E2 are not 
repeated.  However the glitch E3 is repeated in 4.3.8 and 4.4 [6], in the 
in-text listing of the DTD snippets and the complete DTD:
[6] http://docs.oasis-open.org/webcgm/v2.0/OS/WebCGM20-XCF.html#namespace

E4.) Error: 4.3.8: in the DTD snippet, the entity definition of 
"linkuriEXT" is "" instead of EMPTY. Correction: change "" to EMPTY.
E5.) Error: 4.4: in the complete DTD, the entity definition of "linkuriEXT" 
is "" instead of EMPTY. Correction: change "" to EMPTY.

Corrections illustrated:
----------

The proposed DTD-code solution to the errors E1-E3 above is illustrated in 
the file [7]:

[7] http://docs.oasis-open.org/webcgm/v2.0/OS/webcgm20-20070124.dtd

This file is NOT approved or officially endorsed in any manner.  That 
requires OASIS errata processing by the TC.

Furthermore, the file [7] will NOT be the specific replacement DTD file 
that is submitted to the errata process.  Although the specific corrections 
E1-E3 as included in [7] are endorsed by the originator and by Dave 
Cruikshank, the actual replacement DTD file that is ultimately approved by 
the errata process will also have history and version-control information 
in the initial comments section.

Summary:
----------

This is purely a heads-up and information for users and TC members.  It is 
not to be construed as the initiation of the errata process, which formal 
step will follow in the near future, and does not to imply any sort of 
official status or approval of the illustrated corrections.

Clearly, the W3C WebCGM WG will need to run a parallel erratum process, and 
coordinate the timing.  More later.


Regards,
Lofton.