OASIS Darwin Information Typing Architecture (DITA) TC

 View Only

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

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

    Posted 10-22-2014 20:28
    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 ( bob.thomas@tagsmiths.com ) or Skype Time zone: Mountain (GMT-7)