commit 6de648d1539cf06cf61a1a1aad18eb4b41562da1
Author: Alexander Surkov <surkov.alexander@gmail.com>
Date:   Fri Jul 19 14:10:01 2013 -0400

    Bug 12703 - Review/Modify/Add IA2 and ATK role mapping for elements

diff --git a/css/extra.css b/css/extra.css
index 8d7ea3c..da5be84 100644
--- a/css/extra.css
+++ b/css/extra.css
@@ -44,4 +44,13 @@ summary:hover, summary:focus, details[open] summary:hover, details[open] summary
 .show-hide-cols button {background-color: #ddd; font-size: 80%; margin: 0 5px; padding-right: 15px;}
 .show-hide-cols .action {position: absolute; left: -9999em;}
 .show-col {background: url(../img/cross.png) no-repeat right center;}
-.hide-col {background: url(../img/tick.png) no-repeat right center;}
\ No newline at end of file
+.hide-col {background: url(../img/tick.png) no-repeat right center;}
+
+.mapping, .role, .states, .actions, .objattrs, .textattrs {
+    margin-top: 6px;
+    margin-bottom: 6px;
+}
+
+.type {
+  font-weight: bold;
+}
\ No newline at end of file
diff --git a/index.html b/index.html
index 27df853..7e7e846 100644
--- a/index.html
+++ b/index.html
@@ -102,7 +102,19 @@
                         <td>Yes</td>
                         <td><code>link</code> role </td>
                         <td>ROLE_SYSTEM_LINK. Also, apply special rule to expose STATE_LINKED to link and all its descendants.<br><br>Use MSAA or UIA guidance</td>
-                        <td>ROLE_SYSTEM_LINK. Also, apply special rule to expose STATE_LINKED to link and all its descendants.</td>
+                        <td>
+                          <div class="role">
+                            <span class="type">Role: </span>ROLE_SYSTEM_LINK
+                          </div>
+                          <div class="states">
+                            <span class="type">States: </span>
+                            STATE_SYSTEM_LINKED to link and all its descendants. If link is visited then STATE_SYSTEM_TRAVERSED.
+                          </div>
+                          <div class="actions">
+                            <span class="type">Actions: </span>
+                            "jump" action on link and all its descendants.
+                          </div>
+                        </td>
                         <td>HyperLink</td>
                         <td>ROLE_LINK</td>
                         <td>AXLink<br>(null)<br>link</td>
@@ -113,7 +125,12 @@
                         <td>Yes</td>
                         <td>none</td>
                         <td>ROLE_SYSTEM_TEXT<br><br>Use MSAA or UIA guidance</td>
-                        <td>ROLE_SYSTEM_TEXT</td>
+                        <td>
+                          <div class="role">
+                            <span class="type">Role: </span>
+                            tag name BSTR (MSAA) and IA2_ROLE_TEXT_FRAME
+                          </div>
+                        </td>
                         <td>Text</td>
                         <td>ROLE_TEXT</td>
                         <td>AXGroup<br>(null)<br>group</td>
@@ -124,7 +141,12 @@
                         <td>Yes</td>
                         <td>none</td>
                         <td>ROLE_SYSTEM_TEXT<br><br>Use MSAA or UIA guidance</td>
-                        <td>IA2_ROLE_TEXT_FRAME</td>
+                        <td>
+                          <div class="role">
+                            <span class="type">Role: </span>
+                            tag name BSTR (MSAA) and IA2_ROLE_TEXT_FRAME
+                          </div>
+                        </td>
                         <td>Text</td>
                         <td><p>ROLE_TEXT</p>
                     <p>Object attribute role="abbr"</p></td>
@@ -136,8 +158,16 @@
                         <td>Yes</td>
                         <td>none</td>
                         <td>ROLE_SYSTEM_GROUPING<br><br>Use MSAA or UIA guidance</td>
-                        <td><p>IA2_ROLE_PARAGRAPH</p>
-                      <p>Object attribute role="address"</p></td>
+                        <td>
+                          <div class="role">
+                            <span class="type">Role: </span>
+                            tag name BSTR (MSAA) and IA2_ROLE_PARAGRAPH
+                          </div>
+                          <div class="objattrs">
+                            <span class="type">Object attributes: </span>
+                            "xml-roles: address"
+                          </div>
+                        </td>
                         <td>Group</td>
                         <td><p>ROLE_PARAGRAPH</p>
                     <p>Object attribute role="address"</p></td>
@@ -149,7 +179,16 @@
                         <td>Yes</td>
                         <td><code title="attr-aria-role-link">link</code> role </td>
                         <td>ROLE_SYSTEM_LINK. Also, apply special rule to expose STATE_LINKED to link and all its descendants.<br><br>Use MSAA or UIA guidance</td>
-                        <td>ROLE_SYSTEM_LINK. Also, apply special rule to expose STATE_LINKED to link and all its descendants.</td>
+                        <td>
+                          <div class="role">
+                            <span class="type">Role: </span>
+                            ROLE_SYSTEM_LINK exposed as a child of connected HTML:img element
+                          </div>
+                          <div class="states">
+                            <span class="type">States: </span>
+                            STATE_LINKED
+                          </div>
+                        </td>
                         <td>HyperLink</td>
                         <td>ROLE_LINK</td>
                         <td>AXLink<br>(null)<br>link</td>
@@ -160,7 +199,12 @@
                         <td>Yes</td>
                         <td>none</td>
                         <td>ROLE_SYSTEM_TEXT<br><br>Use MSAA or UIA guidance</td>
-                        <td>ROLE_SYSTEM_TEXT</td>
+                        <td>
+                          <div class="role">
+                            <span class="type">Role: </span>
+                            tag name BSTR (MSAA) and IA2_ROLE_SHAPE
+                          </div>
+                        </td>
                         <td>Text</td>
                         <td>ROLE_TEXT</td>
                         <td>Not mapped</td>
@@ -171,7 +215,20 @@
                         <td>Yes</td>
                         <td><code title="attr-aria-role-article">article</code> role </td>
                         <td>ROLE_SYSTEM_DOCUMENT + STATE_SYSTEM_READONLY<br><br>??ROLE_SYSTEM_GROUPING?<br><br>Use MSAA or UIA guidance</td>
-                        <td>ROLE_SYSTEM_DOCUMENT + STATE_SYSTEM_READONLY</td>
+                        <td>
+                          <div class="role">
+                            <span class="type">Role: </span>
+                            ROLE_SYSTEM_DOCUMENT
+                          </div>
+                          <div class="states">
+                            <span class="type">States: </span>
+                            STATE_SYSTEM_READONLY
+                          </div>
+                          <div class="objattrs">
+                            <span class="type">Object attributes: </span>
+                            "xml-roles: article"
+                          </div>
+                        </td>
                         <td>??Group or Text??</td>
                         <td>ROLE_DOCUMENT_FRAME + do not expose STATE_EDITABLE</td>
                         <td>AXGroup<br>AXDocumentArticle<br>article</td>
@@ -182,7 +239,16 @@
                         <td>Yes</td>
                         <td><code title="attr-aria-role-note">complementary</code> role </td>
                         <td>ROLE_SYSTEM_GROUPING<br><br>Use MSAA or UIA guidance</td>
-                        <td>IA2_ROLE_COMPLEMENTARY_CONTENT<br><br>Object attribute role="complementary"</td>
+                        <td>
+                          <div class="role">
+                            <span class="type">Role: </span>
+                            tag name BSTR (MSAA) and IA2_ROLE_NOTE
+                          </div>
+                          <div class="objattrs">
+                            <span class="type">Object attributes: </span>
+                            "xml-roles: complementary"
+                          </div>
+                        </td>
                         <td>Group</td>
                         <td>ROLE_SECTION<br><br>Object attribute role="complementary"</td>
                         <td>AXGroup<br>AXLandmarkComplementary<br>complementary</td>
@@ -193,7 +259,12 @@
                         <td>Yes</td>
                         <td>none</td>
                         <td>ROLE_SYSTEM_GROUPING<br><br>?</td>
-                        <td>ROLE_SYSTEM_GROUPING</td>
+                        <td>
+                          <div class="role">
+                            <span class="type">Role: </span>
+                            ROLE_SYSTEM_GROUPING
+                          </div>
+                        </td>
                         <td>Group</td>
                         <td>ROLE_PANEL</td>
                         <td><p>AXGroup<br>(null)<br>group</p><p><strong>Note: </strong>UI controls within the audio element exposed as AXToolbar.</p></td>
@@ -204,7 +275,12 @@
                         <td>Yes</td>
                         <td>none</td>
                         <td>ROLE_SYSTEM_TEXT<br><br>Use MSAA or UIA guidance</td>
-                        <td>ROLE_SYSTEM_TEXT</td>
+                        <td>
+                          <div class="mapping">Doesn't have an accessible, exposed as
+                            "font-weight" text attribute on the text container.
+                            The value depends on the platform.
+                          </div>
+                        </td>
                         <td>Text</td>
                         <td>ROLE_TEXT</td>
                         <td>AXGroup<br>(null)<br>group</td>
@@ -215,7 +291,9 @@
                         <td>Yes</td>
                         <td>none</td>
                         <td>Not mapped<br><br>Not mapped</td>
-                        <td>Not mapped</td>
+                        <td>
+                          <div class="mapping">Not mapped</div>
+                        </td>
                         <td>Not mapped</td>
                         <td>Not mapped</td>
                         <td>Not mapped</td>
@@ -226,7 +304,11 @@
                         <td></td>
                         <td>none</td>
                         <td></td>
-                        <td></td>
+                        <td>
+                          <div class="mapping">Doesn't have an accessible. May affect on
+                            "writing-mode" text attribute on the text container.
+                          </div>
+                        </td>
                         <td></td>
                         <td></td>
                         <td></td>
@@ -237,7 +319,11 @@
                         <td>Yes</td>
                         <td>none</td>
                         <td>ROLE_SYSTEM_TEXT<br><br>Use MSAA or UIA guidance</td>
-                        <td>ROLE_SYSTEM_TEXT</td>
+                        <td>
+                          <div class="mapping">Doesn't have an accessible.
+                              Exposed as "writing-mode" text attribute on the text container.
+                          </div>
+                        </td>
                         <td>text</td>
                         <td>ROLE_TEXT</td>
                         <td>AXGroup<br>(null)<br>group</td>