add pin-related shortcuts to help modal (#562)

Author: bakkot

src/Spec.ts

@@ -1366,6 +1366,8 @@ ${await utils.readFile(path.join(__dirname, '../js/multipage.js'))}
   <li><span>Toggle "can call user code" annotations</span><code>u</code></li>
 ${this.opts.multipage ? `<li><span>Navigate to/from multipage</span><code>m</code></li>` : ''}
   <li><span>Jump to search box</span><code>/</code></li>
+  <li><span>Toggle pinning of the current clause</span><code>p</code></li>
+  <li><span>Jump to <i>n</i>th pin</span><code>1-9</code></li>
 </ul>`;
     return shortcutsHelp;
   }

test/baselines/generated-reference/algorithm-replacements.html

@@ -5,6 +5,8 @@
   <li><span>Toggle "can call user code" annotations</span><code>u</code></li>
 
   <li><span>Jump to search box</span><code>/</code></li>
+  <li><span>Toggle pinning of the current clause</span><code>p</code></li>
+  <li><span>Jump to <i>n</i>th pin</span><code>1-9</code></li>
 </ul></div><div id="spec-container">
 
 <emu-clause id="test">

test/baselines/generated-reference/algorithms.html

@@ -5,6 +5,8 @@
   <li><span>Toggle "can call user code" annotations</span><code>u</code></li>
 
   <li><span>Jump to search box</span><code>/</code></li>
+  <li><span>Toggle pinning of the current clause</span><code>p</code></li>
+  <li><span>Jump to <i>n</i>th pin</span><code>1-9</code></li>
 </ul></div><div id="spec-container">
 <emu-biblio href="./algorithmsBiblio.json"></emu-biblio>
 <emu-alg><ol><li>Can call <emu-xref href="#sec-algorithm-conventions-abstract-operations"><a href="https://tc39.es/ecma262/#sec-algorithm-conventions-abstract-operations">abstract operations</a></emu-xref> in this spec: <emu-xref aoid="Internal" id="_ref_0"><a href="#sec-internal">Internal</a></emu-xref>();</li><li>Can call <emu-xref href="#sec-algorithm-conventions-abstract-operations"><a href="https://tc39.es/ecma262/#sec-algorithm-conventions-abstract-operations">abstract operations</a></emu-xref> in ES6: <emu-xref aoid="ReturnIfAbrupt"><a href="https://tc39.es/ecma262/#sec-returnifabrupt">ReturnIfAbrupt</a></emu-xref>(<var>completion</var>);</li><li>Can call <emu-xref href="#sec-algorithm-conventions-abstract-operations"><a href="https://tc39.es/ecma262/#sec-algorithm-conventions-abstract-operations">abstract operations</a></emu-xref> in a biblio file: <emu-xref aoid="Biblio"><a href="http://example.com/fooSite.html#sec-biblio">Biblio</a></emu-xref>();</li><li>Unfound <emu-xref href="#sec-algorithm-conventions-abstract-operations"><a href="https://tc39.es/ecma262/#sec-algorithm-conventions-abstract-operations">abstract operations</a></emu-xref> just don't link: Unfound();</li><li>Can prefix with !&nbsp;and ?.<ol><li>Let <var>foo</var> be ?&nbsp;<emu-xref aoid="Internal" id="_ref_1"><a href="#sec-internal">Internal</a></emu-xref>();</li><li>Set <var>foo</var> to !&nbsp;<emu-xref aoid="Internal" id="_ref_2"><a href="#sec-internal">Internal</a></emu-xref>();</li><li>Set <var>foo</var> to !&nbsp;SDO of <var>operation</var>.</li><li>Set <var>foo</var> to !&nbsp;<var>operation</var>.<var class="field">[[MOP]]</var>().</li></ol></li><li>A <emu-xref href="#sec-list-and-record-specification-type"><a href="https://tc39.es/ecma262/#sec-list-and-record-specification-type">Record</a></emu-xref> looks like this: <emu-xref href="#sec-list-and-record-specification-type"><a href="https://tc39.es/ecma262/#sec-list-and-record-specification-type">Record</a></emu-xref> { <var class="field">[[Key]]</var>: 0&nbsp;}.</li><li>A <emu-xref href="#sec-list-and-record-specification-type"><a href="https://tc39.es/ecma262/#sec-list-and-record-specification-type">List</a></emu-xref> looks like this: « 0, 1&nbsp;».</li></ol></emu-alg>

test/baselines/generated-reference/autolinking.html

@@ -5,6 +5,8 @@
   <li><span>Toggle "can call user code" annotations</span><code>u</code></li>
 
   <li><span>Jump to search box</span><code>/</code></li>
+  <li><span>Toggle pinning of the current clause</span><code>p</code></li>
+  <li><span>Jump to <i>n</i>th pin</span><code>1-9</code></li>
 </ul></div><div id="spec-container">
 <emu-clause id="sec-foo">
   <h1><span class="secnum">1</span> Autolinking</h1>

test/baselines/generated-reference/boilerplate-address.html

@@ -5,6 +5,8 @@
   <li><span>Toggle "can call user code" annotations</span><code>u</code></li>
 
   <li><span>Jump to search box</span><code>/</code></li>
+  <li><span>Toggle pinning of the current clause</span><code>p</code></li>
+  <li><span>Jump to <i>n</i>th pin</span><code>1-9</code></li>
 </ul></div><div id="spec-container"><h1 class="title">test title!</h1>
 
 <emu-annex id="sec-copyright-and-software-license">

test/baselines/generated-reference/boilerplate-all.html

@@ -5,6 +5,8 @@
   <li><span>Toggle "can call user code" annotations</span><code>u</code></li>
 
   <li><span>Jump to search box</span><code>/</code></li>
+  <li><span>Toggle pinning of the current clause</span><code>p</code></li>
+  <li><span>Jump to <i>n</i>th pin</span><code>1-9</code></li>
 </ul></div><div id="spec-container"><h1 class="title">test title!</h1>
 
 <emu-annex id="sec-copyright-and-software-license">

test/baselines/generated-reference/boilerplate-copyright.html

@@ -5,6 +5,8 @@
   <li><span>Toggle "can call user code" annotations</span><code>u</code></li>
 
   <li><span>Jump to search box</span><code>/</code></li>
+  <li><span>Toggle pinning of the current clause</span><code>p</code></li>
+  <li><span>Jump to <i>n</i>th pin</span><code>1-9</code></li>
 </ul></div><div id="spec-container"><h1 class="title">test title!</h1>
 
 <emu-annex id="sec-copyright-and-software-license">

test/baselines/generated-reference/boilerplate-license.html

@@ -5,6 +5,8 @@
   <li><span>Toggle "can call user code" annotations</span><code>u</code></li>
 
   <li><span>Jump to search box</span><code>/</code></li>
+  <li><span>Toggle pinning of the current clause</span><code>p</code></li>
+  <li><span>Jump to <i>n</i>th pin</span><code>1-9</code></li>
 </ul></div><div id="spec-container"><h1 class="title">test title!</h1>
 
 <emu-annex id="sec-copyright-and-software-license">

test/baselines/generated-reference/charset-absent.html

@@ -5,5 +5,7 @@
   <li><span>Toggle "can call user code" annotations</span><code>u</code></li>
 
   <li><span>Jump to search box</span><code>/</code></li>
+  <li><span>Toggle pinning of the current clause</span><code>p</code></li>
+  <li><span>Jump to <i>n</i>th pin</span><code>1-9</code></li>
 </ul></div><div id="spec-container">
 </div></body>

test/baselines/generated-reference/charset-present.html

@@ -6,6 +6,8 @@
   <li><span>Toggle "can call user code" annotations</span><code>u</code></li>
 
   <li><span>Jump to search box</span><code>/</code></li>
+  <li><span>Toggle pinning of the current clause</span><code>p</code></li>
+  <li><span>Jump to <i>n</i>th pin</span><code>1-9</code></li>
 </ul></div><div id="spec-container">
 
 </div></body>

test/baselines/generated-reference/clauses.html

@@ -5,6 +5,8 @@
   <li><span>Toggle "can call user code" annotations</span><code>u</code></li>
 
   <li><span>Jump to search box</span><code>/</code></li>
+  <li><span>Toggle pinning of the current clause</span><code>p</code></li>
+  <li><span>Jump to <i>n</i>th pin</span><code>1-9</code></li>
 </ul></div><div id="spec-container">
 <div><h2>Table of Contents</h2><ol class="toc"><li><a href="#sec-intro" title="Intro">Intro</a><ol class="toc"><li><a href="#sec-intro2" title="Sub Intro">Sub Intro</a></li></ol></li><li><a href="#sec-clause" title="Clause Foo(a, b)"><span class="secnum">1</span> Clause Foo(<var>a</var>, <var>b</var>)</a><ol class="toc"><li><a href="#Foo" title="Sub Clause"><span class="secnum">1.1</span> Sub Clause</a></li></ol></li><li><a href="#sec-number" title="Explicit number"><span class="secnum">7</span> Explicit number</a><ol class="toc"><li><a href="#sec-number1" title="Automatic number inside explicit number"><span class="secnum">7.1</span> Automatic number inside explicit number</a></li><li><a href="#sec-number2" title="Nested explicit number"><span class="secnum">7.4</span> Nested explicit number</a></li><li><a href="#sec-number3" title="Automatic number after explicit number"><span class="secnum">7.5</span> Automatic number after explicit number</a></li><li><a href="#sec-number-nested" title="Multi-step explicit numbers"><span class="secnum">7.6</span> Multi-step explicit numbers</a><ol class="toc"><li><a href="#sec-number-multi-step" title="Multi-step explicit numbers"><span class="secnum">7.6.1.1</span> Multi-step explicit numbers</a></li><li><a href="#sec-number-multi-step-1" title="Automatic number after explicit number"><span class="secnum">7.6.1.2</span> Automatic number after explicit number</a><ol class="toc"><li><a href="#sec-number-multi-step-inner" title="Nested clause after explicit multi-step number"><span class="secnum">7.6.1.2.1</span> Nested clause after explicit multi-step number</a></li></ol></li><li><a href="#sec-number-multi-step-2" title="Increasing multi-step explicit numbers"><span class="secnum">7.6.2.1</span> Increasing multi-step explicit numbers</a></li></ol></li></ol></li><li><a href="#sec-annex" title="Annex"><span class="secnum">A</span> Annex</a><ol class="toc"><li><a href="#sec-annex2" title="Sub-annex"><span class="secnum">A.1</span> Sub-annex</a></li></ol></li></ol></div><emu-intro id="sec-intro">
   <h1>Intro</h1>

test/baselines/generated-reference/code.html

@@ -5,6 +5,8 @@
   <li><span>Toggle "can call user code" annotations</span><code>u</code></li>
 
   <li><span>Jump to search box</span><code>/</code></li>
+  <li><span>Toggle pinning of the current clause</span><code>p</code></li>
+  <li><span>Jump to <i>n</i>th pin</span><code>1-9</code></li>
 </ul></div><div id="spec-container">
 <link rel="stylesheet" href="css/elements.css">
 <emu-clause id="foo">

test/baselines/generated-reference/copyright.html

@@ -5,6 +5,8 @@
   <li><span>Toggle "can call user code" annotations</span><code>u</code></li>
 
   <li><span>Jump to search box</span><code>/</code></li>
+  <li><span>Toggle pinning of the current clause</span><code>p</code></li>
+  <li><span>Jump to <i>n</i>th pin</span><code>1-9</code></li>
 </ul></div><div id="spec-container"><h1 class="version">Draft 1 / September 26, 2014</h1><h1 class="title">test title!</h1>
 <emu-clause id="sec-clause">
   <h1><span class="secnum">1</span> Test Clause</h1>

test/baselines/generated-reference/date.html

@@ -5,6 +5,8 @@
   <li><span>Toggle "can call user code" annotations</span><code>u</code></li>
 
   <li><span>Jump to search box</span><code>/</code></li>
+  <li><span>Toggle pinning of the current clause</span><code>p</code></li>
+  <li><span>Jump to <i>n</i>th pin</span><code>1-9</code></li>
 </ul></div><div id="spec-container"><h1 class="title">test title!</h1>
 
 <p>Some body content</p>

test/baselines/generated-reference/dfn.html

@@ -5,6 +5,8 @@
   <li><span>Toggle "can call user code" annotations</span><code>u</code></li>
 
   <li><span>Jump to search box</span><code>/</code></li>
+  <li><span>Toggle pinning of the current clause</span><code>p</code></li>
+  <li><span>Jump to <i>n</i>th pin</span><code>1-9</code></li>
 </ul></div><div id="spec-container">
 <emu-intro id="sec-intro">
   <h1>Intro</h1>

test/baselines/generated-reference/duplicate-ids.html

@@ -5,6 +5,8 @@
   <li><span>Toggle "can call user code" annotations</span><code>u</code></li>
 
   <li><span>Jump to search box</span><code>/</code></li>
+  <li><span>Toggle pinning of the current clause</span><code>p</code></li>
+  <li><span>Jump to <i>n</i>th pin</span><code>1-9</code></li>
 </ul></div><div id="spec-container">
 <emu-clause id="sec-a">
   <h1><span class="secnum">1</span> A</h1>

test/baselines/generated-reference/duplicate-productions.html

@@ -5,6 +5,8 @@
   <li><span>Toggle "can call user code" annotations</span><code>u</code></li>
 
   <li><span>Jump to search box</span><code>/</code></li>
+  <li><span>Toggle pinning of the current clause</span><code>p</code></li>
+  <li><span>Jump to <i>n</i>th pin</span><code>1-9</code></li>
 </ul></div><div id="spec-container">
 <emu-production name="Prod"><emu-nt><a href="#prod-Prod">Prod</a></emu-nt> <emu-geq>:</emu-geq> </emu-production>
 <emu-grammar><emu-production name="GMD" type="lexical">

test/baselines/generated-reference/ecmarkdown.html

@@ -5,6 +5,8 @@
   <li><span>Toggle "can call user code" annotations</span><code>u</code></li>
 
   <li><span>Jump to search box</span><code>/</code></li>
+  <li><span>Toggle pinning of the current clause</span><code>p</code></li>
+  <li><span>Jump to <i>n</i>th pin</span><code>1-9</code></li>
 </ul></div><div id="spec-container">
 <emu-clause id="sec-foo">
   <h1><span class="secnum">1</span> ecmarkdown basics</h1>

test/baselines/generated-reference/effect-user-code.html

@@ -5,6 +5,8 @@
   <li><span>Toggle "can call user code" annotations</span><code>u</code></li>
 
   <li><span>Jump to search box</span><code>/</code></li>
+  <li><span>Toggle pinning of the current clause</span><code>p</code></li>
+  <li><span>Jump to <i>n</i>th pin</span><code>1-9</code></li>
 </ul></div><div id="spec-container">
 
 <emu-clause id="sec-user-code" type="abstract operation" aoid="UserCode">

test/baselines/generated-reference/emd-in-grammar.html

@@ -5,6 +5,8 @@
   <li><span>Toggle "can call user code" annotations</span><code>u</code></li>
 
   <li><span>Jump to search box</span><code>/</code></li>
+  <li><span>Toggle pinning of the current clause</span><code>p</code></li>
+  <li><span>Jump to <i>n</i>th pin</span><code>1-9</code></li>
 </ul></div><div id="spec-container">
 
 <emu-clause id="sec-example">

test/baselines/generated-reference/eqn.html

@@ -6,6 +6,8 @@
   <li><span>Toggle "can call user code" annotations</span><code>u</code></li>
 
   <li><span>Jump to search box</span><code>/</code></li>
+  <li><span>Toggle pinning of the current clause</span><code>p</code></li>
+  <li><span>Jump to <i>n</i>th pin</span><code>1-9</code></li>
 </ul></div><div id="spec-container">
 <emu-clause id="sec-example">
   <h1><span class="secnum">1</span> Header</h1>

test/baselines/generated-reference/escaping.html

@@ -5,6 +5,8 @@
   <li><span>Toggle "can call user code" annotations</span><code>u</code></li>
 
   <li><span>Jump to search box</span><code>/</code></li>
+  <li><span>Toggle pinning of the current clause</span><code>p</code></li>
+  <li><span>Jump to <i>n</i>th pin</span><code>1-9</code></li>
 </ul></div><div id="spec-container">
 <emu-clause id="blah">
 <h1><span class="secnum">1</span> blah</h1>

test/baselines/generated-reference/example.html

@@ -5,6 +5,8 @@
   <li><span>Toggle "can call user code" annotations</span><code>u</code></li>
 
   <li><span>Jump to search box</span><code>/</code></li>
+  <li><span>Toggle pinning of the current clause</span><code>p</code></li>
+  <li><span>Jump to <i>n</i>th pin</span><code>1-9</code></li>
 </ul></div><div id="spec-container">
 <p>Examples outside of clauses aren't processed specially.</p>
 <emu-example>

test/baselines/generated-reference/figure.html

@@ -5,6 +5,8 @@
   <li><span>Toggle "can call user code" annotations</span><code>u</code></li>
 
   <li><span>Jump to search box</span><code>/</code></li>
+  <li><span>Toggle pinning of the current clause</span><code>p</code></li>
+  <li><span>Jump to <i>n</i>th pin</span><code>1-9</code></li>
 </ul></div><div id="spec-container">
 <link rel="stylesheet" href="css/elements.css">
 <emu-figure id="figure-1"><figure><figcaption>Figure 1</figcaption>

test/baselines/generated-reference/grammar.html

@@ -6,6 +6,8 @@
   <li><span>Toggle "can call user code" annotations</span><code>u</code></li>
 
   <li><span>Jump to search box</span><code>/</code></li>
+  <li><span>Toggle pinning of the current clause</span><code>p</code></li>
+  <li><span>Jump to <i>n</i>th pin</span><code>1-9</code></li>
 </ul></div><div id="spec-container">
 
 <emu-grammar type="definition"><emu-production name="FooTerminal" id="prod-FooTerminal">

test/baselines/generated-reference/html-element-attributes.html

@@ -5,6 +5,8 @@
   <li><span>Toggle "can call user code" annotations</span><code>u</code></li>
 
   <li><span>Jump to search box</span><code>/</code></li>
+  <li><span>Toggle pinning of the current clause</span><code>p</code></li>
+  <li><span>Jump to <i>n</i>th pin</span><code>1-9</code></li>
 </ul></div><div id="spec-container">
 Content
 

test/baselines/generated-reference/imports.html

@@ -5,6 +5,8 @@
   <li><span>Toggle "can call user code" annotations</span><code>u</code></li>
 
   <li><span>Jump to search box</span><code>/</code></li>
+  <li><span>Toggle pinning of the current clause</span><code>p</code></li>
+  <li><span>Jump to <i>n</i>th pin</span><code>1-9</code></li>
 </ul></div><div id="spec-container">
 <emu-import href="imports/import1.html"><emu-clause id="Baz" aoid="Baz">
   <h1><span class="secnum">1</span> Header</h1>

test/baselines/generated-reference/ins-nonterminal.html

@@ -5,6 +5,8 @@
   <li><span>Toggle "can call user code" annotations</span><code>u</code></li>
 
   <li><span>Jump to search box</span><code>/</code></li>
+  <li><span>Toggle pinning of the current clause</span><code>p</code></li>
+  <li><span>Jump to <i>n</i>th pin</span><code>1-9</code></li>
 </ul></div><div id="spec-container">
 
 <emu-production name="A" type="lexical" oneof="" primary="" id="prod-A">

test/baselines/generated-reference/multipage.html/index.html

@@ -9,6 +9,8 @@
   <li><span>Toggle "can call user code" annotations</span><code>u</code></li>
 <li><span>Navigate to/from multipage</span><code>m</code></li>
   <li><span>Jump to search box</span><code>/</code></li>
+  <li><span>Toggle pinning of the current clause</span><code>p</code></li>
+  <li><span>Jump to <i>n</i>th pin</span><code>1-9</code></li>
 </ul></div><div id="menu-toggle"><svg xmlns="http://www.w3.org/2000/svg" style="width:100%; height:100%; stroke:currentColor" viewBox="0 0 120 120">
       <title>Menu</title>
       <path stroke-width="10" stroke-linecap="round" d="M30,60 h60  M30,30 m0,5 h60  M30,90 m0,-5 h60"></path>

test/baselines/generated-reference/multipage.html/multipage/index.html

@@ -14,6 +14,8 @@
   <li><span>Toggle "can call user code" annotations</span><code>u</code></li>
 <li><span>Navigate to/from multipage</span><code>m</code></li>
   <li><span>Jump to search box</span><code>/</code></li>
+  <li><span>Toggle pinning of the current clause</span><code>p</code></li>
+  <li><span>Jump to <i>n</i>th pin</span><code>1-9</code></li>
 </ul></div><div id='spec-container'><emu-intro id="sec-intro">
   <h1>Intro</h1>
   <p>Some text.</p>

test/baselines/generated-reference/multipage.html/multipage/second.html

@@ -14,6 +14,8 @@
   <li><span>Toggle "can call user code" annotations</span><code>u</code></li>
 <li><span>Navigate to/from multipage</span><code>m</code></li>
   <li><span>Jump to search box</span><code>/</code></li>
+  <li><span>Toggle pinning of the current clause</span><code>p</code></li>
+  <li><span>Jump to <i>n</i>th pin</span><code>1-9</code></li>
 </ul></div><div id='spec-container'><emu-clause id="sec-second">
   <h1><span class="secnum">1</span> Second Clause</h1>
   <p>A cross-section reference: <emu-xref aoid="Alg" id="_ref_0"><a href="third.html#sec-alg">Alg</a></emu-xref>.</p>

test/baselines/generated-reference/multipage.html/multipage/third.html

@@ -14,6 +14,8 @@
   <li><span>Toggle "can call user code" annotations</span><code>u</code></li>
 <li><span>Navigate to/from multipage</span><code>m</code></li>
   <li><span>Jump to search box</span><code>/</code></li>
+  <li><span>Toggle pinning of the current clause</span><code>p</code></li>
+  <li><span>Jump to <i>n</i>th pin</span><code>1-9</code></li>
 </ul></div><div id='spec-container'><emu-clause id="sec-third">
   <h1><span class="secnum">2</span> Third Clause</h1>
   <p>Some text.</p>

test/baselines/generated-reference/namespaces-productions.html

@@ -5,6 +5,8 @@
   <li><span>Toggle "can call user code" annotations</span><code>u</code></li>
 
   <li><span>Jump to search box</span><code>/</code></li>
+  <li><span>Toggle pinning of the current clause</span><code>p</code></li>
+  <li><span>Jump to <i>n</i>th pin</span><code>1-9</code></li>
 </ul></div><div id="spec-container">
 <emu-intro id="intro" namespace="intro">
   <h1>Intro</h1>

test/baselines/generated-reference/namespaces.html

@@ -5,6 +5,8 @@
   <li><span>Toggle "can call user code" annotations</span><code>u</code></li>
 
   <li><span>Jump to search box</span><code>/</code></li>
+  <li><span>Toggle pinning of the current clause</span><code>p</code></li>
+  <li><span>Jump to <i>n</i>th pin</span><code>1-9</code></li>
 </ul></div><div id="spec-container">
 <emu-intro namespace="intro" aoid="SomeAlg" id="i1">
   <h1>Intro</h1>

test/baselines/generated-reference/nonterminal-used-before-definition.html

@@ -5,6 +5,8 @@
   <li><span>Toggle "can call user code" annotations</span><code>u</code></li>
 
   <li><span>Jump to search box</span><code>/</code></li>
+  <li><span>Toggle pinning of the current clause</span><code>p</code></li>
+  <li><span>Jump to <i>n</i>th pin</span><code>1-9</code></li>
 </ul></div><div id="spec-container">
 <emu-clause id="sec-example-sdo">
   <h1><span class="secnum">1</span> Example SDO</h1>

test/baselines/generated-reference/notes.html

@@ -5,6 +5,8 @@
   <li><span>Toggle "can call user code" annotations</span><code>u</code></li>
 
   <li><span>Jump to search box</span><code>/</code></li>
+  <li><span>Toggle pinning of the current clause</span><code>p</code></li>
+  <li><span>Jump to <i>n</i>th pin</span><code>1-9</code></li>
 </ul></div><div id="spec-container">
 <emu-note>This is a note. Since it is outside a clause it is unstyled.</emu-note>
 

test/baselines/generated-reference/oldids.html

@@ -5,6 +5,8 @@
   <li><span>Toggle "can call user code" annotations</span><code>u</code></li>
 
   <li><span>Jump to search box</span><code>/</code></li>
+  <li><span>Toggle pinning of the current clause</span><code>p</code></li>
+  <li><span>Jump to <i>n</i>th pin</span><code>1-9</code></li>
 </ul></div><div id="spec-container">
 <emu-clause id="c1" oldids="old1,old2"><span id="old2"></span><span id="old1"></span>
   <h1><span class="secnum">1</span> c1</h1>