hixie: Add informative text about editing tables (whatwg r6595)

hixie: Add informative text about editing tables (whatwg r6595)

http://dev.w3.org/cvsweb/html5/spec/Overview.html?r1=1.5288&r2=1.5289&f=h
http://html5.org/tools/web-apps-tracker?from=6594&to=6595

===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.5288
retrieving revision 1.5289
diff -u -d -r1.5288 -r1.5289
--- Overview.html 27 Sep 2011 19:37:57 -0000 1.5288
+++ Overview.html 27 Sep 2011 21:33:39 -0000 1.5289
@@ -723,7 +723,8 @@
      <li><a href="#the-del-element"><span class="secno">4.7.2 </span>The <code>del</code> element</a></li>
      <li><a href="#attributes-common-to-ins-and-del-elements"><span class="secno">4.7.3 </span>Attributes common to <code>ins</code> and <code>del</code> elements</a></li>
      <li><a href="#edits-and-paragraphs"><span class="secno">4.7.4 </span>Edits and paragraphs</a></li>
-     <li><a href="#edits-and-lists"><span class="secno">4.7.5 </span>Edits and lists</a></ol></li>
+     <li><a href="#edits-and-lists"><span class="secno">4.7.5 </span>Edits and lists</a></li>
+     <li><a href="#edits-and-tables"><span class="secno">4.7.6 </span>Edits and tables</a></ol></li>
    <li><a href="#embedded-content-1"><span class="secno">4.8 </span>Embedded content</a>
     <ol>
      <li><a href="#the-img-element"><span class="secno">4.8.1 </span>The <code>img</code> element</a>
@@ -18168,7 +18169,39 @@
  &lt;li&gt;&lt;ins&gt;Purple&lt;/ins&gt;&lt;/li&gt;
 &lt;/ul&gt;</pre>
 
-  </div><h3 id="embedded-content-1"><span class="secno">4.8 </span>Embedded content</h3><h4 id="the-img-element"><span class="secno">4.8.1 </span>The <dfn><code>img</code></dfn> element</h4><dl class="element"><dt>Categories</dt>
+  </div><h4 id="edits-and-tables"><span class="secno">4.7.6 </span>Edits and tables</h4><p><i>This section is non-normative.</i><p>The elements that form part of the table model have complicated
+  content model requirements that do not allow for the
+  <code><a href="#the-ins-element">ins</a></code> and <code><a href="#the-del-element">del</a></code> elements, so indicating edits
+  to a table can be difficult.<p>To indicate that an entire row or an entire column has been added
+  or removed, the entire contents of each cell in that row or column
+  can be wrapped in <code><a href="#the-ins-element">ins</a></code> or <code><a href="#the-del-element">del</a></code> elements
+  (respectively).<div class="example">
+
+   <p>Here, a table's row has been added:</p>
+
+   <pre>&lt;table&gt;
+ &lt;thead&gt;
+  &lt;tr&gt; &lt;th&gt; Game name           &lt;th&gt; Game publisher   &lt;th&gt; Verdict
+ &lt;tbody&gt;
+  &lt;tr&gt; &lt;td&gt; Diablo 2            &lt;td&gt; Blizzard         &lt;td&gt; 8/10
+  &lt;tr&gt; &lt;td&gt; Portal              &lt;td&gt; Valve            &lt;td&gt; 10/10
+<strong>  &lt;tr&gt; &lt;td&gt; &lt;ins&gt;Portal 2&lt;/ins&gt; &lt;td&gt; &lt;ins&gt;Valve&lt;/ins&gt; &lt;td&gt; &lt;ins&gt;10/10&lt;/ins&gt;</strong>
+&lt;/table&gt;</pre>
+
+   <p>Here, a a column has been removed (the time at which it was removed is given also, as is a link to the page explaining why):</p>
+
+   <pre>&lt;table&gt;
+ &lt;thead&gt;
+  &lt;tr&gt; &lt;th&gt; Game name           &lt;th&gt; Game publisher   &lt;th&gt; <strong>&lt;del cite="/edits/r192" datetime="2011-05-02T14:23Z"&gt;Verdict&lt;/del&gt;</strong>
+ &lt;tbody&gt;
+  &lt;tr&gt; &lt;td&gt; Diablo 2            &lt;td&gt; Blizzard         &lt;td&gt; <strong>&lt;del cite="/edits/r192" datetime="2011-05-02T14:23Z"&gt;8/10&lt;/del&gt;</strong>
+  &lt;tr&gt; &lt;td&gt; Portal              &lt;td&gt; Valve            &lt;td&gt; <strong>&lt;del cite="/edits/r192" datetime="2011-05-02T14:23Z"&gt;10/10&lt;/del&gt;</strong>
+  &lt;tr&gt; &lt;td&gt; Portal 2            &lt;td&gt; Valve            &lt;td&gt; <strong>&lt;del cite="/edits/r192" datetime="2011-05-02T14:23Z"&gt;10/10&lt;/del&gt;</strong>
+&lt;/table&gt;</pre>
+
+  </div><p>Generally speaking, there is no good way to indicate more
+  complicated edits (e.g. that a cell was removed, moving all
+  subsequent cells up or to the left).<h3 id="embedded-content-1"><span class="secno">4.8 </span>Embedded content</h3><h4 id="the-img-element"><span class="secno">4.8.1 </span>The <dfn><code>img</code></dfn> element</h4><dl class="element"><dt>Categories</dt>
    <dd><a href="#flow-content">Flow content</a>.</dd>
    <dd><a href="#phrasing-content">Phrasing content</a>.</dd>
    <dd><a href="#embedded-content">Embedded content</a>.</dd>

Received on Tuesday, 27 September 2011 21:34:00 UTC