From 3ddfa5075faa2be9cbd0773b418113b93da1ce9a Mon Sep 17 00:00:00 2001
From: Keith Cirkel <keithamus@users.noreply.github.com>
Date: Thu, 12 Oct 2023 09:44:35 +0100
Subject: [PATCH] Editorial: make shape attributes table consistent

Helps with #9832.
---
 source | 44 +++++++++++++++++++++++++-------------------
 1 file changed, 25 insertions(+), 19 deletions(-)

diff --git a/source b/source
index 9d0696e5ef7..85ec979dfc2 100644
--- a/source
+++ b/source
@@ -41489,50 +41489,56 @@ 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>
+  <table class="yesno">
    <thead>
     <tr>
+     <th>Keyword
+     <th w-nodev>Conforming
      <th>State
-     <th>Keywords
-     <th w-nodev>Notes
+     <th w-nodev>Brief description
    <tbody>
     <tr>
-     <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><span data-x="attr-area-shape-circle">Circle state</span>
+     <td w-dev><span data-x="attr-area-shape-circle">Circle state</span>
+     <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
+     <td class="no">No
     <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><span data-x="attr-area-shape-default">Default state</span>
+     <td w-nodev>This area is the whole image. (The <code data-x="attr-area-coords">coords</code>
+     attribute is not used.)
     <tr>
-     <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>
+     <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 w-nodev rowspan=2>Designates a polygon, using at-least six integers in the <code
+     data-x="attr-area-coords">coords</code> attribute.
     <tr w-nodev>
      <td><dfn><code data-x="attr-area-shape-keyword-polygon">polygon</code></dfn>
-     <td>Non-conforming
+     <td class="no">No
     <tr>
-     <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><span data-x="attr-area-shape-rect">Rectangle state</span>
+     <td w-dev><span data-x="attr-area-shape-rect">Rectangle state</span>
+     <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 class="no">No
   </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>The <dfn element-attr for="area"><code data-x="attr-area-coords">coords</code></dfn> attribute