From beb2615b29dfed4833b60dc6446515a62e5f74ae Mon Sep 17 00:00:00 2001
From: Raphael Kubo da Costa <raphael.kubo.da.costa@intel.com>
Date: Tue, 31 Oct 2023 18:22:09 +0100
Subject: [PATCH] editorial: Use more precise terms to define
 WakeLockSentinel.onrelease

- Say onrelease is an event handler IDL attribute instead of just an event
  handler.
- Use a name to refer to the event handler itself (it is called "onrelease").
- Make the "release" event handler type a <dfn> and refer to it in the rest of
  the spec.

This commit does not introduce any user-visible changes.
---
 index.html | 18 ++++++++++--------
 1 file changed, 10 insertions(+), 8 deletions(-)

diff --git a/index.html b/index.html
index 66c09de..e34e619 100644
--- a/index.html
+++ b/index.html
@@ -517,9 +517,10 @@ <h3 data-tests="wakelock-onrelease.https.html">
           The <dfn>onrelease</dfn> attribute
         </h3>
         <p>
-          The {{WakeLockSentinel/onrelease}} attribute is an <a>event
-          handler</a> whose corresponding <a>event handler event type</a> is
-          <code>release</code>.
+          The {{WakeLockSentinel/onrelease}} attribute is an <a>event handler
+          IDL attribute</a> for the "<code>onrelease</code>" <a>event
+          handler</a>, whose <a>event handler event type</a> is
+          "<dfn><code>release</code></dfn>".
         </p>
         <p>
           It is used to notify scripts that a given {{WakeLockSentinel}}
@@ -545,10 +546,11 @@ <h3>
         </h3>
         <p>
           While a {{WakeLockSentinel}} object has one or more event listeners
-          registered for "release", and the {{WakeLockSentinel}} object hasn't
-          already been released, there MUST be a strong reference from the
-          {{Window}} object that the {{WakeLockSentinel}} object's constructor
-          was invoked from to the {{WakeLockSentinel}} object itself.
+          registered for "<a><code>release</code></a>", and the
+          {{WakeLockSentinel}} object hasn't already been released, there MUST
+          be a strong reference from the {{Window}} object that the
+          {{WakeLockSentinel}} object's constructor was invoked from to the
+          {{WakeLockSentinel}} object itself.
         </p>
         <p>
           While there is a task queued by an {{WakeLockSentinel}} object on the
@@ -738,7 +740,7 @@ <h3>
           <li>Set |lock|'s {{WakeLockSentinel/[[Released]]}} to `true`.
           </li>
           <li>
-            <a>Fire an event</a> named "`release`" at |lock|.
+            <a>Fire an event</a> named "<a><code>release</code></a>" at |lock|.
           </li>
         </ol>
       </section>