Editorial: make shape attributes table consistent

Helps with #9832.
whatwg · Oct 16, 2023 · ce3bb26 · ce3bb26
1 parent 3ca0811
commit ce3bb26
Showing 1 changed file with 25 additions and 17 deletions.
diff --git a/source b/source
@@ -41489,52 +41489,60 @@ interface <dfn interface>HTMLAreaElement</dfn> : <span>HTMLElement</span> {
   data-x="attr-area-coords">coords</code> attributes specify the area.</p>
 
   <p>The <dfn element-attr for="area"><code data-x="attr-area-shape">shape</code></dfn> attribute is
-  an <span>enumerated attribute</span>. The following table lists the keywords defined for this
-  attribute. The states given in the first cell of the rows with keywords give the states to which
-  those keywords map.  <span w-nodev>Some of the keywords are non-conforming, as noted in the last
-  column.</span></p>
+  an <span>enumerated attribute</span> with the following keywords and states:</p>
 
   <table>
    <thead>
     <tr>
-     <th>State
-     <th>Keywords
+     <th>Keyword
      <th w-nodev>Notes
+     <th>State
+     <th w-nodev>Brief description
    <tbody>
     <tr>
+     <td><dfn><code data-x="attr-area-shape-keyword-circle">circle</code></dfn>
+     <td>
      <td w-nodev rowspan=2><span data-x="attr-area-shape-circle">Circle state</span>
      <td w-dev><span data-x="attr-area-shape-circle">Circle state</span>
-     <td><dfn><code data-x="attr-area-shape-keyword-circle">circle</code></dfn>
-     <td w-nodev>
+     <td w-nodev rowspan=2>Designates a circle, using exactly three integers in the <code
+     data-x="attr-area-coords">coords</code> attribute.
     <tr w-nodev>
      <td><dfn><code data-x="attr-area-shape-keyword-circ">circ</code></dfn>
      <td>Non-conforming
     <tr>
-     <td><span data-x="attr-area-shape-default">Default state</span>
      <td><dfn><code data-x="attr-area-shape-keyword-default">default</code></dfn>
-     <td w-nodev>
+     <td>
+     <td><span data-x="attr-area-shape-default">Default state</span>
+     <td w-nodev rowspan=2>Designates a polygon, using at-least six integers in the <code
+     data-x="attr-area-coords">coords</code> attribute.
     <tr>
+     <td><dfn><code data-x="attr-area-shape-keyword-poly">poly</code></dfn>
+     <td>
      <td w-nodev rowspan=2><span data-x="attr-area-shape-poly">Polygon state</span>
      <td w-dev><span data-x="attr-area-shape-poly">Polygon state</span>
-     <td><dfn><code data-x="attr-area-shape-keyword-poly">poly</code></dfn>
-     <td w-nodev>
     <tr w-nodev>
      <td><dfn><code data-x="attr-area-shape-keyword-polygon">polygon</code></dfn>
      <td>Non-conforming
     <tr>
+     <td><dfn><code data-x="attr-area-shape-keyword-rect">rect</code></dfn>
+     <td>
      <td w-nodev rowspan=2><span data-x="attr-area-shape-rect">Rectangle state</span>
      <td w-dev><span data-x="attr-area-shape-rect">Rectangle state</span>
-     <td><dfn><code data-x="attr-area-shape-keyword-rect">rect</code></dfn>
-     <td w-nodev>
+     <td w-nodev rowspan=2>Designates a rectangle, using exactly four integers in the <code
+     data-x="attr-area-coords">coords</code> attribute.
     <tr w-nodev>
      <td><dfn><code data-x="attr-area-shape-keyword-rectangle">rectangle</code></dfn>
-     <td w-nodev>Non-conforming
+     <td>Non-conforming
   </table>
 
-  <p>The attribute may be omitted. The <i data-x="missing value default">missing value default</i>
-  and <i data-x="invalid value default">invalid value default</i> are the <span
+  <p>The attribute's <i data-x="missing value default">missing value default</i> and <i
+  data-x="invalid value default">invalid value default</i> are both the <span
   data-x="attr-area-shape-rect">rectangle</span> state.</p>
 
+  <p>Note the <code data-x="attr-area-shape-keyword-circ">circ</code>, <code
+  data-x="attr-area-shape-keyword-polygon">polygon</code>, and <code
+  data-x="attr-area-shape-keyword-rectangle">rectangle</code>, keywords are non-conforming.
+
   <p>The <dfn element-attr for="area"><code data-x="attr-area-coords">coords</code></dfn> attribute
   must, if specified, contain a <span>valid list of floating-point numbers</span>. This attribute
   gives the coordinates for the shape described by the <code data-x="attr-area-shape">shape</code>