[gnome-doc-utils/mallard] [mallard] Finished off ITS conformance doc for now

[Shaun McCance <shaunm src gnome org>]

commit f79dfb32b99f7d95e79903d07938b148ec5deaf0
Author: Shaun McCance <shaunm gnome org>
Date:   Wed May 27 09:07:59 2009 -0500

    [mallard] Finished off ITS conformance doc for now
---
 doc/mallard/C/its.xml |   41 +++++++++++++++++++++++++----------------
 1 files changed, 25 insertions(+), 16 deletions(-)

diff --git a/doc/mallard/C/its.xml b/doc/mallard/C/its.xml
index 3aabf05..5a3e91e 100644
--- a/doc/mallard/C/its.xml
+++ b/doc/mallard/C/its.xml
@@ -5,7 +5,7 @@
 <info>
   <link type="guide" xref="explore#i18n"/>
 
-  <version number="0.1" date="2009-05-26" status="incomplete"/>
+  <version number="0.1" date="2009-05-27" status="review"/>
 
   <credit type="author">
     <name>Shaun McCance</name>
@@ -15,16 +15,23 @@
     <year>2009</year>
     <name>Shaun McCance</name>
   </copyright>
+
+  <desc>Conformance to the W3C Internationalization and Localization
+  Markup Requirements.</desc>
 </info>
 
 <title>ITS Conformance</title>
 
 <p>This page discusses Mallard's conformance to the requirements in the
-<link href="http://www.w3.org/TR/itsreq/";>W3C Internationalization
-and Localization Markup Requirements</link>, as well as its usage of
-attributes from the <link href="http://www.w3.org/TR/its/";>W3C
+<link href="http://www.w3.org/TR/itsreq/";>W3C Internationalization and
+Localization Markup Requirements</link>, as well as its usage of attributes
+and elements from the <link href="http://www.w3.org/TR/its/";>W3C
 Internationalization Tag Set</link>.</p>
 
+<note><p>As of the time of this writing, there are 26 requirements, though not
+all of them are complete.  This page discusses a selection of the requirements.
+Future versions may discuss more requirements.</p></note>
+
 <section id="R002">
   <title>R002: Span-Like Element</title>
 
@@ -59,7 +66,7 @@ Internationalization Tag Set</link>.</p>
   <code xref="mal_page">page</code> and <code xref="mal_section">section</code>
   elements, Mallard does allow attributes from external namespaces to be used
   on all elements.  If necessary for translation purposes, any attribute from
-  an external attribute may be used as a unique identifier.  In particular,
+  an external namespace may be used as a unique identifier.  In particular,
   Mallard does not use the common <code>xml:id</code> for page and section
   IDs, but it may be used on any element to provide a unique identifier for
   translation or any other purposes.</p>
@@ -106,11 +113,11 @@ Internationalization Tag Set</link>.</p>
     information or linked to external terminology data.</p>
   </quote>
 
-  <comment>
-    <cite date="2009-05-26">shaunm</cite>
-    <p>FIXME: not sure what this is asking for.  Is this something we need
-    to address directly, or something we get for free with external attrs?</p>
-  </comment>
+  <p>Mallard does not currently provide a means of marking up terms and
+  definitions.  When necessary for translation purposes, the
+  <link href="http://www.w3.org/TR/its/#terminology";><code>its:term</code>
+  and <code>its:termInfoRef</code></link> attributes may be used on any
+  elements to indicate such a relationship.</p>
 </section>
 
 <section id="R008">
@@ -127,10 +134,12 @@ Internationalization Tag Set</link>.</p>
     representation (such as the Internationalization Tag Set).</p>
   </quote>
 
-  <comment>
-    <cite date="2009-05-26">shaunm</cite>
-    <p>FIXME: need to look into this more.</p>
-  </comment>
+  <p>Any purpose mapping that can be encoded using the
+  <code href="http://www.w3.org/TR/its/#basic-concepts-selection-global";>its:rules</code>
+  element can be included in a Mallard document.  The <code>its:rules</code> element
+  may be used in any <code xref="mal_info">info</code> element.  See also
+  <link href="http://www.w3.org/TR/its/#associating-its-with-existing-markup";>Associating
+  ITS Data Categories with Existing Markup</link>.</p>
 </section>
 
 <section id="R011">
@@ -166,7 +175,7 @@ Internationalization Tag Set</link>.</p>
   translated.</p>
 
   <p>Additionally, the
-  <code href="http://www.w3.org/TR/its/#trans-datacat";>its:rules</code>
+  <code href="http://www.w3.org/TR/its/#basic-concepts-selection-global";>its:rules</code>
   element may be used in any <code xref="mal_info">info</code> element to
   provide translatability rules for a page or section.</p>
 </section>
@@ -227,7 +236,7 @@ Internationalization Tag Set</link>.</p>
 
   <p>If more extensive localization notes are needed, the
   <code xref="mal_block_comment">comment</code> element may be used.  Using a
-  <code href="http://www.w3.org/TR/its/#trans-datacat";>its:rules</code>
+  <code href="http://www.w3.org/TR/its/#basic-concepts-selection-global";>its:rules</code>
   element in an <code xref="mal_info">info</code> element, one can clearly
   specify which editorial comments are localization notes.</p>
 </section>