Entity definition comparison between legacy 1.2 DTDs and RNG-sourced 1.2 DTDs.

Hi,

I extracted all of the entity definitions from the legacy 1.2 DTDs downloaded from OASIS and then from the 1.2 DTDs in SVN that were generated from the 1.2 RNGs. I then did a side-by-side comparison. There were very few problems. Most of the issues listed in the table have to do with name mismatches, and they can probably be ignored (see note 2).

Notes 

When I say that a
parameter entity needs to be wrapped, I mean that it should be wrapped with
parenthesis. For example: %month; becomes (%month;)

Some parameter
entities have been renamed. In each case, the parameter entity is only used to
integrate other components into the file where the parameter entity has been defined.
Moreover, these parameter entities are only referred to from within the same
files. I believe that it is safe to assume that no one who is following the
rules for specialization will be referring to these parameter entities from
outside of the files where they are defined. Therefore, it would be safe to
leave the new names alone. Nonetheless, I have noted them in the specific findings even
though I don’t recommend changing them back to their legacy names.

The old 1.2 DTDs
(legacy) all use PUBLIC identifiers to call in DTD components. The new 1.2 DTDs all
use SYSTEM identifiers to do this. This would be an issue if somebody wished to re-distribute the DTDs using a different directory structure.

Specific findings

 
  

   
   
File

   
   
   
Entity

   
   
   
Issue

   
  

 
 

  
  
base/dtd/tblDecl.mod

  
 

  
  
  
bodyatt

  
  
  
Definition is missing

  
 

 

  
  
table.attributes

  
  
  
%bodyatt; is missing

  
 

 

  
  
tblDecl-def

  
  
  
Legacy name is tableXML

  
 

 

  
  
base/dtd/map.mod

  
 

  
  
  
included-domains

  
  
  
&included-domains; is invoked without being defined.
  In the legacy map.mod, included-domains was defined in the DOMAINS ATTRIBUTE
  OVERRIDE section, which is missing in the new map.mod.

  
 

 

  
  
commonElements-def

  
  
  
Invocation occurs in a different place in the module. Legacy
  name is commonElements

  
 

 

  
  
metaDecl-def

  
  
  
Invocation occurs in a different place in the module. Legacy
  name is metaXML

  
 

 

  
  
[Not
  Applicable]

  
  
  
Missing section headings for COMMON ATTLIST SETS, MODULES
  CALLS, and DOMAINS ATTRIBUTE OVERRIDE

  
 

 

  
  bookmap/dtd/bookmap.mod
  
  
  
  
completed.content

  
AND

  
started.content

  
  
  
  
Wrap
  %day;, %month;, and %year;

  
  
 

 

  
  
learning/dtd/learningAssessment.dtd

  
learning/dtd/learningContent.dtd

  
  
  
learningBase-type

  
  
  
Legacy name is

  learningBase-typemod

  
 

 

  
  
learning/dtd/learningContent.dtd

  
  
  
learningContent-type

  
  
  
Legacy name is 
learningContent-typemod

  
 

 

  
  
learning/dtd/learningContent.dtd

  
technicalContent/dtd/ditabase.dtd

  
technicalContent/dtd/reference.dtd

  
  
  
reference-type

  
  
  
Legacy name is

  reference-typemod

  
 

 

  
  
learning/dtd/learningOverview.dtd

  
  
  
learningOverview-type

  
  
  
Legacy name is learningOverview-typemod

  
 

 

  
  
learning/dtd/learningPlan.dtd

  
  
  
learningPlan-type

  
  
  
Legacy name is

  learningPlan-typemod

  
 

 

  
  
learning/dtd/learningContent.dtd

  
learning/dtd/learningSummary.dtd

  
  
  
learningSummary-type

  
  
  
Legacy name is

  learningSummary-typemod

  
 

 

  
  
machineryIndustry/dtd/machineryTask.dtd

  
  
  
taskbody-def

  
  
  
Legacy name is

  machineryTaskbody-c-def

  
 

 

  
  
technicalContent/dtd/ditabase.dtd

  
technicalContent/dtd/glossentry.dtd

  
technicalContent/dtd/glossgroup.dtd

  
  
  
glossentry-type

  
  
  Legacy name is
glossentry-typemod
  
 

 

  
  
technicalContent/dtd/ditabase.dtd

  
technicalContent/dtd/glossgroup.dtd

  
  
  
glossgroup-type

  
  
  
Legacy name is

  glossgroup-typemod

  
 

 

  
  
technicalContent/dtd/task.mod

  
  
  
steps.content

  
AND

  
steps-unordered.content

  
  
  
Wrap %step;

  
 

 

  
  
strictTaskbody-def

  
  
  
Legacy name is

  strictTaskbody-c-def

  
 

 

  
  
technicalContent/dtd/taskreqDomain.mod

  
  
  
reqpers.content

  
  
  
Wrap %personnel;

  
 

Best Regards,

-- 
Bob Thomas
+1 720 201 8260

Skype: bob.thomas.colorado

Instant messaging: Gmail chat () or Skype

Time zone: Mountain (GMT-7)