From 9ca1a1c1c7bf56e39b516c299b4e0d3efe59652b Mon Sep 17 00:00:00 2001
From: Alexander Kassouni <alex@kassouni.net>
Date: Tue, 8 Sep 2026 20:11:06 -0700
Subject: better docs

---
 docs/editor.html | 33 ++++++++++++++++++++-------------
 1 file changed, 20 insertions(+), 13 deletions(-)

(limited to 'docs/editor.html')

diff --git a/docs/editor.html b/docs/editor.html
index 8e46242..22349d5 100644
--- a/docs/editor.html
+++ b/docs/editor.html
@@ -72,7 +72,7 @@ typing '0'  →  Sou_VoiceStart(subtrack, 0x53)  →  instrument 0x52</pre>
 <tr><th>Code range</th><th>Instruments</th><th>Reached by</th></tr>
 <tr><td><code>0x01</code>–<code>0x52</code></td><td>0–81</td><td>the phonology engine — short/long vowels, consonants, all 52 two-character digraphs plus <code>you</code></td></tr>
 <tr><td><code>0x01</code>–<code>0x40</code></td><td></td><td>also the anti-repetition random substitution (<code>rand() &gt;&gt; 2</code>)</td></tr>
-<tr><td><code>0x53</code>–<code>0x76</code></td><td>82–117</td><td><strong>only mode 1</strong> — one entry per digit and letter, in order</td></tr>
+<tr><td><code>0x53</code>–<code>0x76</code></td><td>82–117</td><td><strong>only mode 1</strong> — one entry per digit and letter, in order (on bank 157, instrument 82 is instead the <code>you</code> substitute, see below)</td></tr>
 <tr><td><code>0x77</code></td><td>118</td><td>the <code>you</code> digraph, and nothing else</td></tr>
 </table>
 
@@ -92,24 +92,31 @@ phonology-only bank — and that is exactly what it is.
 <h2>Why bank 157 is short</h2>
 
 <p>Spec 3 (Wendell, Pete, Booker, Jack) uses sequence 244 / bank 157, which has 83
-instruments — codes <code>0x01</code>–<code>0x53</code>. That covers the entire phonology
-output range (<code>≤ 0x52</code>) with one to spare, and omits the letter-name block
-that spec 3 can never reach, since the editor is always spec 5 or 6.</p>
-
-<p>The one real casualty is <code>you</code> (<code>0x77</code>): the sequence's dynamic
-table clamps out-of-range entries to the last routine, so a spec-3 voice saying "you"
-plays instrument 82 instead. That is one wrong syllable on a common word, in four
-NPCs' voices.</p>
+instruments — one more than the phonology output range
+(<code>0x01</code>–<code>0x52</code> → instruments 0–81) — and omits the letter-name
+block that spec 3 can never reach, since the editor is always spec 5 or 6.</p>
+
+<p>The 83rd instrument is not spare. Sequence 244's dynamic table maps codes
+<code>0x53</code>–<code>0x76</code> to explicit silence and maps <code>you</code>
+(<code>0x77</code>) to <strong>instrument 82</strong> — a sample reachable through no
+other path, played at a lower note than the other two voices'
+<code>you</code> (semitone 41 vs 44; see <a href="disc.html">the disc page</a>). So bank
+157 carries a dedicated <code>you</code> substitute, and spec-3 voices lack nothing
+audible. Whether instrument 82 is an actual "you" recording is testable the same way as
+the letter names: extract it and listen.</p>
 
 <div class="note">
-This corrects an earlier reading of <code>extraction.md</code> §2.4, which described bank 157
-as "collapsing every digraph sample above <code>0x53</code> onto one sound". Nothing above
-<code>0x53</code> is a digraph — the block is not phonology at all.
+This corrects two earlier readings. Working notes once described bank 157 as
+"collapsing every digraph sample above <code>0x53</code> onto one sound" — nothing above
+<code>0x53</code> is a digraph, the block is not phonology at all. A later revision of
+these pages then claimed the dynamic table "clamps out-of-range entries to the last
+routine" — it does not; the mapping of <code>0x77</code> → instrument 82 is an explicit
+table entry, verified on disc.
 </div>
 
 <div class="pager">
   <span><a href="soundfont.html">← 6. The soundfont lookup</a></span>
-  <span><a href="quirks.html">8. Quirks &amp; corrections →</a></span>
+  <span><a href="disc.html">8. Walking the disc image →</a></span>
 </div>
 
 </body>
-- 
cgit v1.3.1