[imsc] address ISSUE-382
authorplemieux
Thu, 30 Apr 2015 08:49:44 -0700
changeset 917 5062322f5360
parent 916 bb46ee1c9c18
child 918 14e47051b5af
[imsc] address ISSUE-382
[imsc] formatting tweaks to feature tables
ttml-ww-profiles/ttml-ww-profiles.html
ttml-ww-profiles/ttml-ww-profiles.source.html
--- a/ttml-ww-profiles/ttml-ww-profiles.html	Fri Apr 24 18:08:58 2015 -0700
+++ b/ttml-ww-profiles/ttml-ww-profiles.html	Thu Apr 30 08:49:44 2015 -0700
@@ -241,7 +241,7 @@
   </p>
   <h1 class="title p-name" id="title" property="dcterms:title">TTML Text and Image Profiles for Internet Media Subtitles and Captions 1.0</h1>
   
-  <h2 id="w3c-editor-s-draft-10-april-2015"><abbr title="World Wide Web Consortium">W3C</abbr> Editor's Draft <time property="dcterms:issued" class="dt-published" datetime="2015-04-10">10 April 2015</time></h2>
+  <h2 id="w3c-editor-s-draft-30-april-2015"><abbr title="World Wide Web Consortium">W3C</abbr> Editor's Draft <time property="dcterms:issued" class="dt-published" datetime="2015-04-30">30 April 2015</time></h2>
   <dl>
     
       <dt>This version:</dt>
@@ -1149,14 +1149,14 @@
           <tr>
             <td><code>#extent-region</code></td>
 
-            <td><em class="rfc2119" title="MAY">MAY</em> be used. The <code>tts:extent</code> attribute <em class="rfc2119" title="SHALL">SHALL</em> be present on all <code>region</code> elements.</td>
+            <td><em class="rfc2119" title="MAY">MAY</em> be used, with the following additional constraints:<ul><li>The <code>tts:extent</code> attribute <em class="rfc2119" title="SHALL">SHALL</em> be present on all <code>region</code> elements.</li></ul></td>
           </tr>
 
           <tr>
             <td><code>#extent-root</code></td>
 
-            <td><em class="rfc2119" title="MAY">MAY</em> be used. If the document includes any length value that uses the <code>px</code> expression,
-            <code>tts:extent</code> <em class="rfc2119" title="SHALL">SHALL</em> be present on the <code>tt</code> element.</td>
+            <td><em class="rfc2119" title="MAY">MAY</em> be used, with the following additional constraints:<ul><li>If the document includes any length value that uses the <code>px</code> expression,
+            <code>tts:extent</code> <em class="rfc2119" title="SHALL">SHALL</em> be present on the <code>tt</code> element.</li></ul></td>
           </tr>
 
           <tr>
@@ -1343,8 +1343,8 @@
           <tr>
             <td><code>#tickRate</code></td>
 
-            <td><em class="rfc2119" title="MAY">MAY</em> be used. <code>ttp:tickRate</code> <em class="rfc2119" title="SHALL">SHALL</em> be present on the <code>tt</code> element if the
-            #time-offset-with-ticks feature is used in the document.</td>
+            <td><em class="rfc2119" title="MAY">MAY</em> be used, with the following additional constraints:<ul><li><code>ttp:tickRate</code> <em class="rfc2119" title="SHALL">SHALL</em> be present on the <code>tt</code> element if the
+            #time-offset-with-ticks feature is used in the document.</li></ul></td>
           </tr>
 
           <tr>
@@ -1356,8 +1356,9 @@
           <tr>
             <td><code>#timeBase-media</code></td>
 
-            <td><em class="rfc2119" title="SHALL">SHALL</em> be used. <code>ttp:timeBase</code> <em class="rfc2119" title="SHALL">SHALL</em> be present on the <code>tt</code> element and <em class="rfc2119" title="SHALL">SHALL</em> be equal to
-            "media".</td>
+            <td><em class="rfc2119" title="SHALL">SHALL</em> be used, with the following additional constraints:<ul><li>
+						<code>ttp:timeBase</code> <em class="rfc2119" title="SHALL">SHALL</em> be present on the <code>tt</code> element and <em class="rfc2119" title="SHALL">SHALL</em> be equal to
+            "media".</li></ul></td>
           </tr>
 
           <tr>
@@ -1405,7 +1406,12 @@
           <tr>
             <td><code>#timing</code></td>
 
-            <td><em class="rfc2119" title="MAY">MAY</em> be used. All time expressions within a <a href="#dfn-document-instance" class="internalDFN">Document Instance</a> <em class="rfc2119" title="SHOULD">SHOULD</em> use the same syntax, either <code>clock-time</code> or <code>offset-time</code>.</td>
+            <td><em class="rfc2119" title="MAY">MAY</em> be used, with the following additional constraints:
+						
+						<ul><li>All time expressions within a <a href="#dfn-document-instance" class="internalDFN">Document Instance</a> <em class="rfc2119" title="SHOULD">SHOULD</em> use the same syntax, either <code>clock-time</code> or <code>offset-time</code>; and</li>
+						
+						<li><code>begin</code> and  <code>end</code> attributes <em class="rfc2119" title="SHOULD">SHOULD</em> be specified on either <code>div</code>, <code>p</code> or <code>span</code> elements.</li></ul>
+						</td>
           </tr>
 
           <tr>
@@ -1616,8 +1622,8 @@
           <tr>
             <td><code>#color</code></td>
 
-            <td><em class="rfc2119" title="MAY">MAY</em> be used. The initial value of <code>tts:color</code> <em class="rfc2119" title="SHALL">SHALL</em> be "white". NOTE: This is consistent with
-            [<cite><a class="bibref" href="#bib-ST2052-1">ST2052-1</a></cite>].</td>
+            <td><em class="rfc2119" title="MAY">MAY</em> be used, with the following additional constraints:<ul><li>The initial value of <code>tts:color</code> <em class="rfc2119" title="SHALL">SHALL</em> be "white". NOTE: This is consistent with
+            [<cite><a class="bibref" href="#bib-ST2052-1">ST2052-1</a></cite>].</li></ul></td>
           </tr>
 
           <tr>
@@ -1642,8 +1648,8 @@
           <tr>
             <td><code>#fontFamily-generic</code></td>
 
-            <td><em class="rfc2119" title="MAY">MAY</em> be used. A <code>tts:fontFamily</code> of either "monospaceSerif" or "proportionalSansSerif" <em class="rfc2119" title="SHOULD">SHOULD</em> be
-            specified for all presented text content. A tts:fontFamily of "default" <em class="rfc2119" title="SHALL">SHALL</em> be equivalent to "monospaceSerif".</td>
+            <td><em class="rfc2119" title="MAY">MAY</em> be used, with the following additional constraints:<ul><li>A <code>tts:fontFamily</code> of either <code>"monospaceSerif"</code> or <code>"proportionalSansSerif"</code> <em class="rfc2119" title="SHOULD">SHOULD</em> be
+            specified for all presented text content. A tts:fontFamily of <code>"default"</code> <em class="rfc2119" title="SHALL">SHALL</em> be equivalent to <code>"monospaceSerif"</code>.</li></ul></td>
           </tr>
 
           <tr>
@@ -1721,9 +1727,9 @@
           <tr>
             <td><code>#lineHeight</code></td>
 
-            <td><em class="rfc2119" title="MAY">MAY</em> be used.<br>
+            <td><em class="rfc2119" title="MAY">MAY</em> be used, with the following additional constraints:<ul><li>
             An explicit <code>&lt;length&gt;</code> <em class="rfc2119" title="SHOULD">SHOULD</em> be specified as there is no uniform implementation of the "normal" value
-            at the time of this writing.</td>
+            at the time of this writing.</li></ul></td>
           </tr>
 
           <tr>
@@ -1832,7 +1838,7 @@
           <tr>
             <td><code>#textOutline</code></td>
 
-            <td><em class="rfc2119" title="MAY">MAY</em> be used. If specified, the border thickness <em class="rfc2119" title="SHALL">SHALL</em> be 10% or less than the associated font size.</td>
+            <td><em class="rfc2119" title="MAY">MAY</em> be used, with the following additional constraints:<ul><li>If specified, the border thickness <em class="rfc2119" title="SHALL">SHALL</em> be 10% or less than the associated font size.</li></ul></td>
           </tr>
 
           <tr>
@@ -2572,7 +2578,7 @@
 
         <tbody>
           <tr>
-            <td>monospaceSerif</td>
+            <td><code>monospaceSerif</code></td>
 
             <td>
               All code points specified in <a href="#recommended-unicode-code-points-per-language" class="sec-ref"><span class="secno">B.</span> <span class="sec-title">Recommended Character Sets</span></a>
@@ -2585,7 +2591,7 @@
           </tr>
 
           <tr>
-            <td>proportionalSansSerif</td>
+            <td><code>proportionalSansSerif</code></td>
 
             <td>
               All code points specified in <a href="#recommended-unicode-code-points-per-language" class="sec-ref"><span class="secno">B.</span> <span class="sec-title">Recommended Character Sets</span></a>, excluding the code points
--- a/ttml-ww-profiles/ttml-ww-profiles.source.html	Fri Apr 24 18:08:58 2015 -0700
+++ b/ttml-ww-profiles/ttml-ww-profiles.source.html	Thu Apr 30 08:49:44 2015 -0700
@@ -839,14 +839,14 @@
           <tr>
             <td><code>#extent-region</code></td>
 
-            <td>MAY be used. The <code>tts:extent</code> attribute SHALL be present on all <code>region</code> elements.</td>
+            <td>MAY be used, with the following additional constraints:<ul><li>The <code>tts:extent</code> attribute SHALL be present on all <code>region</code> elements.</li></ul></td>
           </tr>
 
           <tr>
             <td><code>#extent-root</code></td>
 
-            <td>MAY be used. If the document includes any length value that uses the <code>px</code> expression,
-            <code>tts:extent</code> SHALL be present on the <code>tt</code> element.</td>
+            <td>MAY be used, with the following additional constraints:<ul><li>If the document includes any length value that uses the <code>px</code> expression,
+            <code>tts:extent</code> SHALL be present on the <code>tt</code> element.</li></ul></td>
           </tr>
 
           <tr>
@@ -1033,8 +1033,8 @@
           <tr>
             <td><code>#tickRate</code></td>
 
-            <td>MAY be used. <code>ttp:tickRate</code> SHALL be present on the <code>tt</code> element if the
-            #time-offset-with-ticks feature is used in the document.</td>
+            <td>MAY be used, with the following additional constraints:<ul><li><code>ttp:tickRate</code> SHALL be present on the <code>tt</code> element if the
+            #time-offset-with-ticks feature is used in the document.</li></ul></td>
           </tr>
 
           <tr>
@@ -1046,8 +1046,9 @@
           <tr>
             <td><code>#timeBase-media</code></td>
 
-            <td>SHALL be used. <code>ttp:timeBase</code> SHALL be present on the <code>tt</code> element and SHALL be equal to
-            "media".</td>
+            <td>SHALL be used, with the following additional constraints:<ul><li>
+						<code>ttp:timeBase</code> SHALL be present on the <code>tt</code> element and SHALL be equal to
+            "media".</li></ul></td>
           </tr>
 
           <tr>
@@ -1095,7 +1096,12 @@
           <tr>
             <td><code>#timing</code></td>
 
-            <td>MAY be used. All time expressions within a <a>Document Instance</a> SHOULD use the same syntax, either <code>clock-time</code> or <code>offset-time</code>.</td>
+            <td>MAY be used, with the following additional constraints:
+						
+						<ul><li>All time expressions within a <a>Document Instance</a> SHOULD use the same syntax, either <code>clock-time</code> or <code>offset-time</code>; and</li>
+						
+						<li><code>begin</code> and  <code>end</code> attributes SHOULD be specified on either <code>div</code>, <code>p</code> or <code>span</code> elements.</li></ul>
+						</td>
           </tr>
 
           <tr>
@@ -1307,8 +1313,8 @@
           <tr>
             <td><code>#color</code></td>
 
-            <td>MAY be used. The initial value of <code>tts:color</code> SHALL be "white". NOTE: This is consistent with
-            [[ST2052-1]].</td>
+            <td>MAY be used, with the following additional constraints:<ul><li>The initial value of <code>tts:color</code> SHALL be "white". NOTE: This is consistent with
+            [[ST2052-1]].</li></ul></td>
           </tr>
 
           <tr>
@@ -1333,8 +1339,8 @@
           <tr>
             <td><code>#fontFamily-generic</code></td>
 
-            <td>MAY be used. A <code>tts:fontFamily</code> of either "monospaceSerif" or "proportionalSansSerif" SHOULD be
-            specified for all presented text content. A tts:fontFamily of "default" SHALL be equivalent to "monospaceSerif".</td>
+            <td>MAY be used, with the following additional constraints:<ul><li>A <code>tts:fontFamily</code> of either <code>"monospaceSerif"</code> or <code>"proportionalSansSerif"</code> SHOULD be
+            specified for all presented text content. A tts:fontFamily of <code>"default"</code> SHALL be equivalent to <code>"monospaceSerif"</code>.</li></ul></td>
           </tr>
 
           <tr>
@@ -1412,9 +1418,9 @@
           <tr>
             <td><code>#lineHeight</code></td>
 
-            <td>MAY be used.<br>
+            <td>MAY be used, with the following additional constraints:<ul><li>
             An explicit <code>&lt;length&gt;</code> SHOULD be specified as there is no uniform implementation of the "normal" value
-            at the time of this writing.</td>
+            at the time of this writing.</li></ul></td>
           </tr>
 
           <tr>
@@ -1523,7 +1529,7 @@
           <tr>
             <td><code>#textOutline</code></td>
 
-            <td>MAY be used. If specified, the border thickness SHALL be 10% or less than the associated font size.</td>
+            <td>MAY be used, with the following additional constraints:<ul><li>If specified, the border thickness SHALL be 10% or less than the associated font size.</li></ul></td>
           </tr>
 
           <tr>
@@ -2265,7 +2271,7 @@
 
         <tbody>
           <tr>
-            <td>monospaceSerif</td>
+            <td><code>monospaceSerif</code></td>
 
             <td>
               All code points specified in <a href="#recommended-unicode-code-points-per-language"></a>
@@ -2279,7 +2285,7 @@
           </tr>
 
           <tr>
-            <td>proportionalSansSerif</td>
+            <td><code>proportionalSansSerif</code></td>
 
             <td>
               All code points specified in <a href="#recommended-unicode-code-points-per-language"></a>, excluding the code points