From 8670954cd4be5df09f91669f4645cd337216fc91 Mon Sep 17 00:00:00 2001
From: Bradley Needham <bradley.needham@sony.com>
Date: Tue, 21 Feb 2023 13:31:33 -0800
Subject: [PATCH] Specify touchId requires unique ids per origin

Other small formatting updates
---
 extensions.html | 34 +++++++++++++++++++++-------------
 1 file changed, 21 insertions(+), 13 deletions(-)

diff --git a/extensions.html b/extensions.html
index d8c8a47..ee23410 100644
--- a/extensions.html
+++ b/extensions.html
@@ -605,6 +605,12 @@ <h3>
               {{GamepadEffectParameters/weakMagnitude}}, none of which are
               required.
             </p>
+            <p>
+              {{GamepadEffectParameters/startDelay}} and
+              {{GamepadEffectParameters/duration}} set the duration of the
+              initial delay before after initiating the effect before the
+              effect will be started
+            </p>
             <p>
               {{GamepadEffectParameters/startDelay}} sets the duration of the
               delay after {{GamepadHapticActuator/playEffect()}} is called
@@ -828,9 +834,14 @@ <h2>
           <dfn>touchId</dfn> attribute
         </dt>
         <dd>
-          Unique id of the touch event. Range is [0, 4294967295]. The user
-          agent is responsible for incrementing the touchId for each subsequent
-          touch event based on information provided by the device API.
+          Unique id of the touch event. Range is [0, 4294967295].
+          <p>The user agent is responsible for:</p>
+          <ul>
+            <li>Incrementing the id for each subsequent touch event based
+              on information provided by the device API.</li>
+            <li>Maintaining the uniqueness of the id per origin to 
+              prevent fingerprinting.</li>
+          </ul>
           {{GamepadTouch/touchId}} SHOULD be set to a default value of 0 when a
           new {{Gamepad}} object is created.
         </dd>
@@ -930,7 +941,7 @@ <h2>
             <dfn data-dfn-for="Gamepad">[[\touchEvents]]</dfn>
           </td>
           <td>
-            <code>null</code>
+            `null`
           </td>
           <td>
             List of generated touch events.
@@ -942,14 +953,14 @@ <h2>
           <dfn>hand</dfn>
         </dt>
         <dd>
-          An enumeration that indicates which hand the controller is being held
-          in or is most likely to be held in. `"left"`, `"right"`, or `""`.
+          An enumeration, {{GamepadHand}}, that indicates which hand the controller is being held
+          in or is most likely to be held in.
         </dd>
         <dt>
           <dfn>hapticActuators</dfn>
         </dt>
         <dd>
-          A list of all the haptic actuators in the gamepad. The same object
+          A list of all the {{GamepadHapticActuator}}s in the gamepad. The same object
           MUST be returned until the user agent needs to return different
           values (or values in a different order).
         </dd>
@@ -957,7 +968,7 @@ <h2>
           <dfn>pose</dfn>
         </dt>
         <dd>
-          The current pose of the gamepad, if supported by the hardware.
+          The current {{GamepadPose}} of the gamepad, if supported by the hardware.
           Includes position, orientation, velocity, and acceleration. If the
           hardware cannot supply any pose values, MUST be set to `null`.
         </dd>
@@ -966,7 +977,7 @@ <h2>
         </dt>
         <dd>
           <p>
-            A list of touch events generated from all touch surfaces. If the
+            A list of {{GamepadTouch}} events generated from all touch surfaces. If the
             device does not support touch events, MUST be set to `null`.
           </p>
           <p>
@@ -979,7 +990,6 @@ <h2>
             <li>Otherwise return `null`.
             </li>
           </ol>
-
         </dd>
         <dt>
           <dfn>vibrationActuator</dfn>
@@ -988,8 +998,6 @@ <h2>
           A {{GamepadHapticActuator}} capable of generating a haptic effect
           that vibrates the entire gamepad.
         </dd>
-      </dl>
-        </dd>
       </dl>
       <section>
         <h3>
@@ -1010,7 +1018,7 @@ <h3>
           "updating touchEvents">update touchEvents</dfn> by running the
           following steps:
         </p>
-        <ol>
+        <ol class="algorithm">
           <li>Let |surfaceId:unsigned long| be 0.
           </li>
           <li>Remove any existing events from