The following changes include fixes for technical problems in the
specification, as well as numerous corrections to comments in the DTD and
XSD files. The suggested changes are grouped by type, with general changes
first (including all technical problems), followed by incorrect element descriptions,
typos, and entity issues.
||Lists a public ID pointing to topicAttr.ent. The file is actually
||lists 2 files as pointing to topicAttr.ent. The first should go to
topicAttr.mod. The second should go to topicDefn.ent.
||The elements choption, chdesc, choptionhd, and chdeschd all have
their group declaration stating that is a task element.
||For type entry.class, it specifies the default value for class attribute
to be topic/tgroup. It should be topic/entry.
|topic.mod, catalog-dita.txt, catalog-dita.xml
||The wrong public ID is used for tblDecl.mod. When DITA 1.0 was approved,
the tables moved from the CALS model to the OASIS Exchange Table Model. The
public ID was supposed to be updated to reflect this. The comment in tblDecl.mod
indicates this decision, listing the public ID as:
-//OASIS//ELEMENTS DITA Exchange Table Model//EN
the catalogs and topic.mod still refer to this module using the old public
-//OASIS//ELEMENTS DITA CALS Tables//EN
All references should
use the Exchange Table Model ID.
||The domains attribute is defined in map.class in the file mapMod.xsd.
It should actually be defined in the file map.xsd using the redefine mechanism
to include the domains attribute in the map.class content model. This fix
allows users to specialize map and add a different domain.
|map.dtd and map.mod
||Public ID is incorrect:
-//OASIS//Elements DITA Map//EN
-//OASIS//ELEMENTS DITA Map//EN
||The <group> element around the DTDs should not use the xml:base
attribute. The file is delivered in the same directory as the DTDs; it should
be correct as delivered. Vendor implementations can update as appropriate.
||@class and global-atts are declared twice for <title>
||Remove entity declaration for "ut-d-simpletable" in *.ent, remove
header comment about message lists in *.mod (none of the other domains contains
examples in the header - we should just remove the line)
|All topic and map domain files, topicAttr.mod, topicDefn.ent, metaDecl.mod
||Update the "delivered as" system ID to match the real delivery name
||Header lists the PURPOSE as defining items for the Programming Domain.
Should say "Declaring the elements for the base Topic type."
||Header lists the PURPOSE as defining items for DITA XML Metadata.
Should say "Declaring the elements and specialization attributes for the Software
|utilitiesDomain.ent, uiDomain.ent, softwareDomain.ent, programmingDomain.ent,
||Most files include "All rights reserved" after the copyright, these
do not. It should be added to these files.
|ditabase.dtd, map.dtd, ditaarch.xsd, mapMod.xsd, mapGrp.xsd, map.xsd,
||Header says to see license.txt for disclaimers/permissions. This
was the license when the files were distributed on developerWorks. The reference
should be removed.
||Does not contain any copyright statement (tblDecl.mod has the same
copyright as other files). Will copy in the copyright from other XSD files.
|ditabase.xsd, map.xsd, map.dtd
||Update version number in the header. These three use 1.3, all other
files use 1.0. These three should also use 1.0.
The following items have been reported since the last update do
that document, and are included in this list of fixes:
- taskGrp.xsd must be updated. Several elements all declare that they are
the "task" element.
- tblDeclMod.xsd must be updated. The entry element is declared to be topic/tgroup
- it must be topic/entry.
- mapMod.xsd and map.xsd must be updated. The current definition prevents
users from specialization a map and changing the included domains.
2005/11/15: One additional bug has been found in the DTDs.
The table module tblDecl.mod is referenced several times using the old CALS
ID. When the files were approved by OASIS, the expectation was that this module
would be referenced using a new public ID. This intention is clear within
the table module itself, but was not carried through to the referencing files.
Both catalog files and topic.mod should be updated to use the correct public