$Id: readme.txt,v 1.2 2007/02/17 14:36:29 fsasaki Exp $ 
Steps for the integration of ITS into xmlspec-i18n.dtd:

1. added the entity
<!ENTITY % its SYSTEM "its.dtd">
and the entity call
%its;

2. changed the existing entity
<!ENTITY % common.att " id               ID  #IMPLIED
   %role.att;
   %diff.att;
   %local.common.att;>
to
<!ENTITY % common.att " id               ID  #IMPLIED
   %role.att;
   %diff.att;
   %local.common.att;
   %att.local.with-ns.attributes;">

3. changed the entity
<!ENTITY % spec.mdl "header , front? , body , back?">
<!ENTITY % header.mdl "title , subtitle? , version? , w3c-designation , w3c-doctype , pubdate , notice* , publoc , altlocs? , ((prevlocs , latestloc?) | (latestloc , prevlocs?))? , authlist , errataloc? , preverrataloc? , translationloc? , copyright? , ((status , abstract) | (abstract , status)) , pubstmt? , sourcedesc? , langusage , revisiondesc">
to
<!ENTITY % spec.mdl "header , front? , body , back?">
<!ENTITY % header.mdl "title , subtitle? , version? , w3c-designation , w3c-doctype , pubdate , notice* , publoc , altlocs? , ((prevlocs , latestloc?) | (latestloc , prevlocs?))? , authlist , errataloc? , preverrataloc? , translationloc? , copyright? , ((status , abstract) | (abstract , status)) , pubstmt? , sourcedesc? , langusage , revisiondesc, its:rules*">

4. changed the entity
<!ENTITY % p.pcd.mix "#PCDATA|%annot.class;|%termdef.class;|%emph.class; |%ref.class;|%tech.class;|%loc.class;|%ednote.class;%local.p.pcd.mix;">
to
<!ENTITY % p.pcd.mix "#PCDATA|%annot.class;|%termdef.class;|%emph.class; |%ref.class;|%tech.class;|%loc.class;|%ednote.class;%local.p.pcd.mix;|its:ruby">


Problems encountered:

- overlap between ITS and existing declarations. Example: existing declaration from i18n-extensions.mod (which is called by i18n-xmlspec.dtd):
<!ENTITY % l10n.att " locn-note  CDATA  #IMPLIED
   locn-alert CDATA  #IMPLIED
   translate   (yes | no )  #IMPLIED">

- integration of elements is difficult. Example: should "ruby" be part of %p.pcd.mix;, or also of other entities?

- comment from Sebastian Rahtz: Put the ITS definition into the declaration
  subset, so that you don't have to change definitions in the original DTD
