about summary refs log tree commit diff stats
path: root/html/baremetal
diff options
context:
space:
mode:
authorKartik Agaram <vc@akkartik.com>2021-01-14 14:03:32 -0800
committerKartik Agaram <vc@akkartik.com>2021-01-14 14:03:32 -0800
commit20d6be52405130930fde9ca5bb5e95131ba4e659 (patch)
tree82ba4a132db206ef9adc2145d9dfd5aacd34da65 /html/baremetal
parent232b4a1511a63a2c76ee233e7e172f8caa8232bb (diff)
downloadmu-20d6be52405130930fde9ca5bb5e95131ba4e659.tar.gz
7520
Diffstat (limited to 'html/baremetal')
-rw-r--r--html/baremetal/101screen.subx.html90
-rw-r--r--html/baremetal/102keyboard.subx.html83
-rw-r--r--html/baremetal/103grapheme.subx.html226
-rw-r--r--html/baremetal/104test.subx.html93
-rw-r--r--html/baremetal/108write.subx.html271
-rw-r--r--html/baremetal/112read-byte.subx.html75
-rw-r--r--html/baremetal/115write-byte.subx.html75
-rw-r--r--html/baremetal/120allocate.subx.html105
-rw-r--r--html/baremetal/302stack_allocate.subx.html2
-rw-r--r--html/baremetal/309stream.subx.html4
-rw-r--r--html/baremetal/313index-bounds-check.subx.html20
-rw-r--r--html/baremetal/400.mu.html32
-rw-r--r--html/baremetal/403unicode.mu.html12
-rw-r--r--html/baremetal/500clear-screen.mu.html79
-rw-r--r--html/baremetal/501draw-text.mu.html307
-rw-r--r--html/baremetal/502test.mu.html82
-rw-r--r--html/baremetal/503manhattan-line.mu.html4
-rw-r--r--html/baremetal/ex1.subx.html10
-rw-r--r--html/baremetal/ex2.mu.html2
-rw-r--r--html/baremetal/ex2.subx.html44
-rw-r--r--html/baremetal/ex3.mu.html4
-rw-r--r--html/baremetal/ex4.mu.html2
-rw-r--r--html/baremetal/ex6.mu.html10
-rw-r--r--html/baremetal/ex7.mu.html2
-rw-r--r--html/baremetal/mu-init.subx.html22
25 files changed, 970 insertions, 686 deletions
diff --git a/html/baremetal/101screen.subx.html b/html/baremetal/101screen.subx.html
index 038e8f78..1f204a59 100644
--- a/html/baremetal/101screen.subx.html
+++ b/html/baremetal/101screen.subx.html
@@ -56,50 +56,52 @@ if ('onhashchange' in window) {
 <pre id='vimCodeElement'>
 <span id="L1" class="LineNr"> 1 </span><span class="subxComment"># Primitives for screen control.</span>
 <span id="L2" class="LineNr"> 2 </span>
-<span id="L3" class="LineNr"> 3 </span><span class="subxFunction">pixel</span>:  <span class="subxComment"># screen: (addr screen), x: int, y: int, color: int</span>
-<span id="L4" class="LineNr"> 4 </span>    <span class="subxS1Comment"># . prologue</span>
-<span id="L5" class="LineNr"> 5 </span>    55/push-ebp
-<span id="L6" class="LineNr"> 6 </span>    89/&lt;- %ebp 4/r32/esp
-<span id="L7" class="LineNr"> 7 </span>    <span class="subxS1Comment"># . save registers</span>
-<span id="L8" class="LineNr"> 8 </span>    50/push-eax
-<span id="L9" class="LineNr"> 9 </span>    51/push-ecx
-<span id="L10" class="LineNr">10 </span>    <span class="subxComment"># ecx = screen</span>
-<span id="L11" class="LineNr">11 </span>    8b/-&gt; *(ebp+8) 1/r32/ecx
-<span id="L12" class="LineNr">12 </span>    81 7/subop/compare %ecx 0/imm32
-<span id="L13" class="LineNr">13 </span>    {
-<span id="L14" class="LineNr">14 </span>      75/jump-if-!= <span class="Constant">break</span>/disp8
-<span id="L15" class="LineNr">15 </span>      <span class="subxComment"># bounds checks</span>
-<span id="L16" class="LineNr">16 </span>      8b/-&gt; *(ebp+0xc) 0/r32/eax
-<span id="L17" class="LineNr">17 </span>      3d/compare-eax-and 0/imm32
-<span id="L18" class="LineNr">18 </span>      7c/jump-if-&lt; $pixel:end/disp8
-<span id="L19" class="LineNr">19 </span>      3d/compare-eax-and 0x400/imm32/1024
-<span id="L20" class="LineNr">20 </span>      7d/jump-if-&gt;= $pixel:end/disp8
-<span id="L21" class="LineNr">21 </span>      8b/-&gt; *(ebp+0x10) 0/r32/eax
-<span id="L22" class="LineNr">22 </span>      3d/compare-eax-and 0/imm32
-<span id="L23" class="LineNr">23 </span>      7c/jump-if-&lt; $pixel:end/disp8
-<span id="L24" class="LineNr">24 </span>      3d/compare-eax-and 0x300/imm32/768
-<span id="L25" class="LineNr">25 </span>      7d/jump-if-&gt;= $pixel:end/disp8
-<span id="L26" class="LineNr">26 </span>      <span class="subxComment"># eax = y*1024 + x</span>
-<span id="L27" class="LineNr">27 </span>      8b/-&gt; *(ebp+0x10) 0/r32/eax
-<span id="L28" class="LineNr">28 </span>      c1/shift 4/subop/left %eax 0xa/imm8
-<span id="L29" class="LineNr">29 </span>      03/add-&gt; *(ebp+0xc) 0/r32/eax
-<span id="L30" class="LineNr">30 </span>      <span class="subxComment"># eax += location of frame buffer</span>
-<span id="L31" class="LineNr">31 </span>      03/add-&gt; *0x7f28 0/r32/eax
-<span id="L32" class="LineNr">32 </span>      <span class="subxComment"># *eax = color</span>
-<span id="L33" class="LineNr">33 </span>      8b/-&gt; *(ebp+0x14) 1/r32/ecx
-<span id="L34" class="LineNr">34 </span>      88/byte&lt;- *eax 1/r32/CL
-<span id="L35" class="LineNr">35 </span>      <span class="subxComment"># return</span>
-<span id="L36" class="LineNr">36 </span>      eb $pixel:end/disp8
-<span id="L37" class="LineNr">37 </span>    }
-<span id="L38" class="LineNr">38 </span>    <span class="subxComment"># TODO: fake screen</span>
-<span id="L39" class="LineNr">39 </span><span class="Constant">$pixel:end</span>:
-<span id="L40" class="LineNr">40 </span>    <span class="subxS1Comment"># . restore registers</span>
-<span id="L41" class="LineNr">41 </span>    59/pop-to-ecx
-<span id="L42" class="LineNr">42 </span>    58/pop-to-eax
-<span id="L43" class="LineNr">43 </span>    <span class="subxS1Comment"># . epilogue</span>
-<span id="L44" class="LineNr">44 </span>    89/&lt;- %esp 5/r32/ebp
-<span id="L45" class="LineNr">45 </span>    5d/pop-to-ebp
-<span id="L46" class="LineNr">46 </span>    c3/return
+<span id="L3" class="LineNr"> 3 </span>== code
+<span id="L4" class="LineNr"> 4 </span>
+<span id="L5" class="LineNr"> 5 </span><span class="subxFunction">pixel</span>:  <span class="subxComment"># screen: (addr screen), x: int, y: int, color: int</span>
+<span id="L6" class="LineNr"> 6 </span>    <span class="subxS1Comment"># . prologue</span>
+<span id="L7" class="LineNr"> 7 </span>    55/push-ebp
+<span id="L8" class="LineNr"> 8 </span>    89/&lt;- %ebp 4/r32/esp
+<span id="L9" class="LineNr"> 9 </span>    <span class="subxS1Comment"># . save registers</span>
+<span id="L10" class="LineNr">10 </span>    50/push-eax
+<span id="L11" class="LineNr">11 </span>    51/push-ecx
+<span id="L12" class="LineNr">12 </span>    <span class="subxComment"># ecx = screen</span>
+<span id="L13" class="LineNr">13 </span>    8b/-&gt; *(ebp+8) 1/r32/ecx
+<span id="L14" class="LineNr">14 </span>    81 7/subop/compare %ecx 0/imm32
+<span id="L15" class="LineNr">15 </span>    {
+<span id="L16" class="LineNr">16 </span>      75/jump-if-!= <span class="Constant">break</span>/disp8
+<span id="L17" class="LineNr">17 </span>      <span class="subxComment"># bounds checks</span>
+<span id="L18" class="LineNr">18 </span>      8b/-&gt; *(ebp+0xc) 0/r32/eax
+<span id="L19" class="LineNr">19 </span>      3d/compare-eax-and 0/imm32
+<span id="L20" class="LineNr">20 </span>      7c/jump-if-&lt; $pixel:end/disp8
+<span id="L21" class="LineNr">21 </span>      3d/compare-eax-and 0x400/imm32/1024
+<span id="L22" class="LineNr">22 </span>      7d/jump-if-&gt;= $pixel:end/disp8
+<span id="L23" class="LineNr">23 </span>      8b/-&gt; *(ebp+0x10) 0/r32/eax
+<span id="L24" class="LineNr">24 </span>      3d/compare-eax-and 0/imm32
+<span id="L25" class="LineNr">25 </span>      7c/jump-if-&lt; $pixel:end/disp8
+<span id="L26" class="LineNr">26 </span>      3d/compare-eax-and 0x300/imm32/768
+<span id="L27" class="LineNr">27 </span>      7d/jump-if-&gt;= $pixel:end/disp8
+<span id="L28" class="LineNr">28 </span>      <span class="subxComment"># eax = y*1024 + x</span>
+<span id="L29" class="LineNr">29 </span>      8b/-&gt; *(ebp+0x10) 0/r32/eax
+<span id="L30" class="LineNr">30 </span>      c1/shift 4/subop/left %eax 0xa/imm8
+<span id="L31" class="LineNr">31 </span>      03/add-&gt; *(ebp+0xc) 0/r32/eax
+<span id="L32" class="LineNr">32 </span>      <span class="subxComment"># eax += location of frame buffer</span>
+<span id="L33" class="LineNr">33 </span>      03/add-&gt; *0x7f28 0/r32/eax
+<span id="L34" class="LineNr">34 </span>      <span class="subxComment"># *eax = color</span>
+<span id="L35" class="LineNr">35 </span>      8b/-&gt; *(ebp+0x14) 1/r32/ecx
+<span id="L36" class="LineNr">36 </span>      88/byte&lt;- *eax 1/r32/CL
+<span id="L37" class="LineNr">37 </span>      <span class="subxComment"># return</span>
+<span id="L38" class="LineNr">38 </span>      eb $pixel:end/disp8
+<span id="L39" class="LineNr">39 </span>    }
+<span id="L40" class="LineNr">40 </span>    <span class="subxComment"># TODO: fake screen</span>
+<span id="L41" class="LineNr">41 </span><span class="Constant">$pixel:end</span>:
+<span id="L42" class="LineNr">42 </span>    <span class="subxS1Comment"># . restore registers</span>
+<span id="L43" class="LineNr">43 </span>    59/pop-to-ecx
+<span id="L44" class="LineNr">44 </span>    58/pop-to-eax
+<span id="L45" class="LineNr">45 </span>    <span class="subxS1Comment"># . epilogue</span>
+<span id="L46" class="LineNr">46 </span>    89/&lt;- %esp 5/r32/ebp
+<span id="L47" class="LineNr">47 </span>    5d/pop-to-ebp
+<span id="L48" class="LineNr">48 </span>    c3/return
 </pre>
 </body>
 </html>
diff --git a/html/baremetal/102keyboard.subx.html b/html/baremetal/102keyboard.subx.html
index cc092133..660d74fb 100644
--- a/html/baremetal/102keyboard.subx.html
+++ b/html/baremetal/102keyboard.subx.html
@@ -56,46 +56,49 @@ if ('onhashchange' in window) {
 <pre id='vimCodeElement'>
 <span id="L1" class="LineNr"> 1 </span><span class="subxComment"># check keyboard for a key</span>
 <span id="L2" class="LineNr"> 2 </span><span class="subxComment"># return 0 on no keypress or unrecognized key</span>
-<span id="L3" class="LineNr"> 3 </span><span class="subxFunction">read-key</span>:  <span class="subxComment"># kbd: (addr keyboard) -&gt; result/eax: byte</span>
-<span id="L4" class="LineNr"> 4 </span>    <span class="subxS1Comment"># . prologue</span>
-<span id="L5" class="LineNr"> 5 </span>    55/push-ebp
-<span id="L6" class="LineNr"> 6 </span>    89/&lt;- %ebp 4/r32/esp
-<span id="L7" class="LineNr"> 7 </span>    <span class="subxS1Comment"># . save registers</span>
-<span id="L8" class="LineNr"> 8 </span>    51/push-ecx
-<span id="L9" class="LineNr"> 9 </span>    <span class="subxComment"># result = 0</span>
-<span id="L10" class="LineNr">10 </span>    b8/copy-to-eax 0/imm32
-<span id="L11" class="LineNr">11 </span>    <span class="subxComment"># ecx = keyboard</span>
-<span id="L12" class="LineNr">12 </span>    8b/-&gt; *(ebp+8) 1/r32/ecx
-<span id="L13" class="LineNr">13 </span>    81 7/subop/compare %ecx 0/imm32
-<span id="L14" class="LineNr">14 </span>    {
-<span id="L15" class="LineNr">15 </span>      75/jump-if-!= <span class="Constant">break</span>/disp8
-<span id="L16" class="LineNr">16 </span>      <span class="subxComment"># var read/ecx: byte = keyboard buffer's read index</span>
-<span id="L17" class="LineNr">17 </span>      8b/-&gt; *0x7dcc 1/r32/CL  <span class="subxComment"># keyboard-buffer-read</span>
-<span id="L18" class="LineNr">18 </span>      <span class="subxComment"># var next-key/eax: byte = *(keyboard buffer + ecx)</span>
-<span id="L19" class="LineNr">19 </span>      8a/byte-&gt; *(ecx+0x7dd0) 0/r32/AL  <span class="subxComment"># keyboard-buffer-data</span>
-<span id="L20" class="LineNr">20 </span>      <span class="subxComment"># if (next-key != 0) lock and remove from keyboard-buffer</span>
-<span id="L21" class="LineNr">21 </span>      81 7/subop/compare %eax 0/imm32
-<span id="L22" class="LineNr">22 </span>      {
-<span id="L23" class="LineNr">23 </span>        74/jump-if-= <span class="Constant">break</span>/disp8
-<span id="L24" class="LineNr">24 </span>        <span class="subxComment"># TODO: add some instructions in this block to SubX if we ever want to</span>
-<span id="L25" class="LineNr">25 </span>        <span class="subxComment"># use bootstrap on baremetal programs</span>
-<span id="L26" class="LineNr">26 </span>        fa/disable-interrupts
-<span id="L27" class="LineNr">27 </span>        c6 0/subop/copy-byte *(ecx+0x7dd0) 0/imm8
-<span id="L28" class="LineNr">28 </span>        ff 0/subop/increment *0x7dcc  <span class="subxComment"># keyboard-buffer-read</span>
-<span id="L29" class="LineNr">29 </span>        81 4/subop/and *0x7dcc 0xf/imm32  <span class="subxComment"># keyboard-buffer-read</span>
-<span id="L30" class="LineNr">30 </span>        fb/enable-interrupts
-<span id="L31" class="LineNr">31 </span>      }
-<span id="L32" class="LineNr">32 </span>      <span class="subxComment"># return</span>
-<span id="L33" class="LineNr">33 </span>      eb $read-key:end/disp8
-<span id="L34" class="LineNr">34 </span>    }
-<span id="L35" class="LineNr">35 </span>    <span class="subxComment"># TODO: fake keyboard</span>
-<span id="L36" class="LineNr">36 </span><span class="Constant">$read-key:end</span>:
-<span id="L37" class="LineNr">37 </span>    <span class="subxS1Comment"># . restore registers</span>
-<span id="L38" class="LineNr">38 </span>    59/pop-to-ecx
-<span id="L39" class="LineNr">39 </span>    <span class="subxS1Comment"># . epilogue</span>
-<span id="L40" class="LineNr">40 </span>    89/&lt;- %esp 5/r32/ebp
-<span id="L41" class="LineNr">41 </span>    5d/pop-to-ebp
-<span id="L42" class="LineNr">42 </span>    c3/return
+<span id="L3" class="LineNr"> 3 </span>
+<span id="L4" class="LineNr"> 4 </span>== code
+<span id="L5" class="LineNr"> 5 </span>
+<span id="L6" class="LineNr"> 6 </span><span class="subxFunction">read-key</span>:  <span class="subxComment"># kbd: (addr keyboard) -&gt; result/eax: byte</span>
+<span id="L7" class="LineNr"> 7 </span>    <span class="subxS1Comment"># . prologue</span>
+<span id="L8" class="LineNr"> 8 </span>    55/push-ebp
+<span id="L9" class="LineNr"> 9 </span>    89/&lt;- %ebp 4/r32/esp
+<span id="L10" class="LineNr">10 </span>    <span class="subxS1Comment"># . save registers</span>
+<span id="L11" class="LineNr">11 </span>    51/push-ecx
+<span id="L12" class="LineNr">12 </span>    <span class="subxComment"># result = 0</span>
+<span id="L13" class="LineNr">13 </span>    b8/copy-to-eax 0/imm32
+<span id="L14" class="LineNr">14 </span>    <span class="subxComment"># ecx = keyboard</span>
+<span id="L15" class="LineNr">15 </span>    8b/-&gt; *(ebp+8) 1/r32/ecx
+<span id="L16" class="LineNr">16 </span>    81 7/subop/compare %ecx 0/imm32
+<span id="L17" class="LineNr">17 </span>    {
+<span id="L18" class="LineNr">18 </span>      75/jump-if-!= <span class="Constant">break</span>/disp8
+<span id="L19" class="LineNr">19 </span>      <span class="subxComment"># var read/ecx: byte = keyboard buffer's read index</span>
+<span id="L20" class="LineNr">20 </span>      8b/-&gt; *0x7dcc 1/r32/CL  <span class="subxComment"># keyboard-buffer-read</span>
+<span id="L21" class="LineNr">21 </span>      <span class="subxComment"># var next-key/eax: byte = *(keyboard buffer + ecx)</span>
+<span id="L22" class="LineNr">22 </span>      8a/byte-&gt; *(ecx+0x7dd0) 0/r32/AL  <span class="subxComment"># keyboard-buffer-data</span>
+<span id="L23" class="LineNr">23 </span>      <span class="subxComment"># if (next-key != 0) lock and remove from keyboard-buffer</span>
+<span id="L24" class="LineNr">24 </span>      81 7/subop/compare %eax 0/imm32
+<span id="L25" class="LineNr">25 </span>      {
+<span id="L26" class="LineNr">26 </span>        74/jump-if-= <span class="Constant">break</span>/disp8
+<span id="L27" class="LineNr">27 </span>        <span class="subxComment"># TODO: add some instructions in this block to SubX if we ever want to</span>
+<span id="L28" class="LineNr">28 </span>        <span class="subxComment"># use bootstrap on baremetal programs</span>
+<span id="L29" class="LineNr">29 </span>        fa/disable-interrupts
+<span id="L30" class="LineNr">30 </span>        c6 0/subop/copy-byte *(ecx+0x7dd0) 0/imm8
+<span id="L31" class="LineNr">31 </span>        ff 0/subop/increment *0x7dcc  <span class="subxComment"># keyboard-buffer-read</span>
+<span id="L32" class="LineNr">32 </span>        81 4/subop/and *0x7dcc 0xf/imm32  <span class="subxComment"># keyboard-buffer-read</span>
+<span id="L33" class="LineNr">33 </span>        fb/enable-interrupts
+<span id="L34" class="LineNr">34 </span>      }
+<span id="L35" class="LineNr">35 </span>      <span class="subxComment"># return</span>
+<span id="L36" class="LineNr">36 </span>      eb $read-key:end/disp8
+<span id="L37" class="LineNr">37 </span>    }
+<span id="L38" class="LineNr">38 </span>    <span class="subxComment"># TODO: fake keyboard</span>
+<span id="L39" class="LineNr">39 </span><span class="Constant">$read-key:end</span>:
+<span id="L40" class="LineNr">40 </span>    <span class="subxS1Comment"># . restore registers</span>
+<span id="L41" class="LineNr">41 </span>    59/pop-to-ecx
+<span id="L42" class="LineNr">42 </span>    <span class="subxS1Comment"># . epilogue</span>
+<span id="L43" class="LineNr">43 </span>    89/&lt;- %esp 5/r32/ebp
+<span id="L44" class="LineNr">44 </span>    5d/pop-to-ebp
+<span id="L45" class="LineNr">45 </span>    c3/return
 </pre>
 </body>
 </html>
diff --git a/html/baremetal/103grapheme.subx.html b/html/baremetal/103grapheme.subx.html
index 13dc6073..77e1d901 100644
--- a/html/baremetal/103grapheme.subx.html
+++ b/html/baremetal/103grapheme.subx.html
@@ -55,117 +55,121 @@ if ('onhashchange' in window) {
 <body onload='JumpToLine();'>
 <a href='https://github.com/akkartik/mu/blob/main/baremetal/103grapheme.subx'>https://github.com/akkartik/mu/blob/main/baremetal/103grapheme.subx</a>
 <pre id='vimCodeElement'>
-<span id="L1" class="LineNr">  1 </span><span class="subxFunction">draw-grapheme</span>:  <span class="subxComment"># screen: (addr screen), g: grapheme, x: int, y: int, color: int</span>
-<span id="L2" class="LineNr">  2 </span>    <span class="subxS1Comment"># . prologue</span>
-<span id="L3" class="LineNr">  3 </span>    55/push-ebp
-<span id="L4" class="LineNr">  4 </span>    89/&lt;- %ebp 4/r32/esp
-<span id="L5" class="LineNr">  5 </span>    <span class="subxS1Comment"># . save registers</span>
-<span id="L6" class="LineNr">  6 </span>    50/push-eax
-<span id="L7" class="LineNr">  7 </span>    51/push-ecx
-<span id="L8" class="LineNr">  8 </span>    52/push-edx
-<span id="L9" class="LineNr">  9 </span>    53/push-ebx
-<span id="L10" class="LineNr"> 10 </span>    56/push-esi
-<span id="L11" class="LineNr"> 11 </span>    <span class="subxComment"># TODO: support fake screen; we currently assume 'screen' is always 0 (real)</span>
-<span id="L12" class="LineNr"> 12 </span>    <span class="subxComment"># var letter-bitmap/esi = font[g]</span>
-<span id="L13" class="LineNr"> 13 </span>    8b/-&gt; *(ebp+0xc) 6/r32/esi
-<span id="L14" class="LineNr"> 14 </span>    c1 4/subop/shift-left %esi 4/imm8
-<span id="L15" class="LineNr"> 15 </span>    8d/copy-address *(esi+0x8800) 6/r32/esi  <span class="subxComment"># font-start</span>
-<span id="L16" class="LineNr"> 16 </span>    <span class="subxComment"># if (letter-bitmap &gt;= 0x9000) return  # characters beyond ASCII currently not supported</span>
-<span id="L17" class="LineNr"> 17 </span>    81 7/subop/compare %esi 0x9000/imm32
-<span id="L18" class="LineNr"> 18 </span>    7d/jump-if-&gt;= $draw-grapheme:end/disp8
-<span id="L19" class="LineNr"> 19 </span>    <span class="subxComment"># edx = y</span>
-<span id="L20" class="LineNr"> 20 </span>    8b/-&gt; *(ebp+0x14) 2/r32/edx
-<span id="L21" class="LineNr"> 21 </span>    <span class="subxComment"># var ymax/ebx: int = y + 16</span>
-<span id="L22" class="LineNr"> 22 </span>    8b/-&gt; *(ebp+0x14) 3/r32/ebx
-<span id="L23" class="LineNr"> 23 </span>    81 0/subop/add %ebx 0x10/imm32
-<span id="L24" class="LineNr"> 24 </span>    {
-<span id="L25" class="LineNr"> 25 </span>      <span class="subxComment"># if (y &gt;= ymax) break</span>
-<span id="L26" class="LineNr"> 26 </span>      39/compare %edx 3/r32/ebx
-<span id="L27" class="LineNr"> 27 </span>      7d/jump-if-&gt;= <span class="Constant">break</span>/disp8
-<span id="L28" class="LineNr"> 28 </span>      <span class="subxComment"># eax = x + 7</span>
-<span id="L29" class="LineNr"> 29 </span>      8b/-&gt; *(ebp+0x10) 0/r32/eax
-<span id="L30" class="LineNr"> 30 </span>      81 0/subop/add %eax 7/imm32
-<span id="L31" class="LineNr"> 31 </span>      <span class="subxComment"># var xmin/ecx: int = x</span>
-<span id="L32" class="LineNr"> 32 </span>      8b/-&gt; *(ebp+0x10) 1/r32/ecx
-<span id="L33" class="LineNr"> 33 </span>      <span class="subxComment"># var row-bitmap/ebx: int = *letter-bitmap</span>
-<span id="L34" class="LineNr"> 34 </span>      53/push-ebx
-<span id="L35" class="LineNr"> 35 </span>      8b/-&gt; *esi 3/r32/ebx
-<span id="L36" class="LineNr"> 36 </span>      {
-<span id="L37" class="LineNr"> 37 </span>        <span class="subxComment"># if (x &lt; xmin) break</span>
-<span id="L38" class="LineNr"> 38 </span>        39/compare %eax 1/r32/ecx
-<span id="L39" class="LineNr"> 39 </span>        7c/jump-if-&lt; <span class="Constant">break</span>/disp8
-<span id="L40" class="LineNr"> 40 </span>        <span class="subxComment"># shift LSB from row-bitmap into carry flag (CF)</span>
-<span id="L41" class="LineNr"> 41 </span>        c1 5/subop/shift-right-logical %ebx 1/imm8
-<span id="L42" class="LineNr"> 42 </span>        <span class="subxComment"># if LSB, draw a pixel</span>
-<span id="L43" class="LineNr"> 43 </span>        {
-<span id="L44" class="LineNr"> 44 </span>          73/jump-if-not-CF <span class="Constant">break</span>/disp8
-<span id="L45" class="LineNr"> 45 </span>          (<a href='101screen.subx.html#L3'>pixel</a> *(ebp+8) %eax %edx *(ebp+0x18))
-<span id="L46" class="LineNr"> 46 </span>        }
-<span id="L47" class="LineNr"> 47 </span>        <span class="subxComment"># --x</span>
-<span id="L48" class="LineNr"> 48 </span>        48/decrement-eax
-<span id="L49" class="LineNr"> 49 </span>        <span class="subxComment">#</span>
-<span id="L50" class="LineNr"> 50 </span>        eb/jump <span class="Constant">loop</span>/disp8
-<span id="L51" class="LineNr"> 51 </span>      }
-<span id="L52" class="LineNr"> 52 </span>      <span class="subxComment"># reclaim row-bitmap</span>
-<span id="L53" class="LineNr"> 53 </span>      5b/pop-to-ebx
-<span id="L54" class="LineNr"> 54 </span>      <span class="subxComment"># ++y</span>
-<span id="L55" class="LineNr"> 55 </span>      42/increment-edx
-<span id="L56" class="LineNr"> 56 </span>      <span class="subxComment"># next bitmap row</span>
-<span id="L57" class="LineNr"> 57 </span>      46/increment-esi
-<span id="L58" class="LineNr"> 58 </span>      <span class="subxComment">#</span>
-<span id="L59" class="LineNr"> 59 </span>      eb/jump <span class="Constant">loop</span>/disp8
-<span id="L60" class="LineNr"> 60 </span>    }
-<span id="L61" class="LineNr"> 61 </span><span class="Constant">$draw-grapheme:end</span>:
-<span id="L62" class="LineNr"> 62 </span>    <span class="subxS1Comment"># . restore registers</span>
-<span id="L63" class="LineNr"> 63 </span>    5e/pop-to-esi
-<span id="L64" class="LineNr"> 64 </span>    5b/pop-to-ebx
-<span id="L65" class="LineNr"> 65 </span>    5a/pop-to-edx
-<span id="L66" class="LineNr"> 66 </span>    59/pop-to-ecx
-<span id="L67" class="LineNr"> 67 </span>    58/pop-to-eax
-<span id="L68" class="LineNr"> 68 </span>    <span class="subxS1Comment"># . epilogue</span>
-<span id="L69" class="LineNr"> 69 </span>    89/&lt;- %esp 5/r32/ebp
-<span id="L70" class="LineNr"> 70 </span>    5d/pop-to-ebp
-<span id="L71" class="LineNr"> 71 </span>    c3/return
-<span id="L72" class="LineNr"> 72 </span>
-<span id="L73" class="LineNr"> 73 </span><span class="subxFunction">cursor-position</span>:  <span class="subxComment"># screen: (addr screen) -&gt; _/eax: int, _/ecx: int</span>
-<span id="L74" class="LineNr"> 74 </span>    <span class="subxS1Comment"># . prologue</span>
-<span id="L75" class="LineNr"> 75 </span>    55/push-ebp
-<span id="L76" class="LineNr"> 76 </span>    89/&lt;- %ebp 4/r32/esp
-<span id="L77" class="LineNr"> 77 </span>    <span class="subxComment"># TODO: support fake screen; we currently assume 'screen' is always 0 (real)</span>
-<span id="L78" class="LineNr"> 78 </span>    8b/-&gt; *<span class="SpecialChar"><a href='103grapheme.subx.html#L107'>Default-next-x</a></span> 0/r32/eax
-<span id="L79" class="LineNr"> 79 </span>    8b/-&gt; *<span class="SpecialChar"><a href='103grapheme.subx.html#L110'>Default-next-y</a></span> 1/r32/ecx
-<span id="L80" class="LineNr"> 80 </span><span class="Constant">$cursor-position:end</span>:
-<span id="L81" class="LineNr"> 81 </span>    <span class="subxS1Comment"># . epilogue</span>
-<span id="L82" class="LineNr"> 82 </span>    89/&lt;- %esp 5/r32/ebp
-<span id="L83" class="LineNr"> 83 </span>    5d/pop-to-ebp
-<span id="L84" class="LineNr"> 84 </span>    c3/return
-<span id="L85" class="LineNr"> 85 </span>
-<span id="L86" class="LineNr"> 86 </span><span class="subxFunction">set-cursor-position</span>:  <span class="subxComment"># screen: (addr screen), x: int, y: int</span>
-<span id="L87" class="LineNr"> 87 </span>    <span class="subxS1Comment"># . prologue</span>
-<span id="L88" class="LineNr"> 88 </span>    55/push-ebp
-<span id="L89" class="LineNr"> 89 </span>    89/&lt;- %ebp 4/r32/esp
-<span id="L90" class="LineNr"> 90 </span>    <span class="subxS1Comment"># . save registers</span>
-<span id="L91" class="LineNr"> 91 </span>    50/push-eax
-<span id="L92" class="LineNr"> 92 </span>    <span class="subxComment"># TODO: support fake screen; we currently assume 'screen' is always 0 (real)</span>
-<span id="L93" class="LineNr"> 93 </span>    8b/-&gt; *(ebp+0xc) 0/r32/eax
-<span id="L94" class="LineNr"> 94 </span>    89/&lt;- *<span class="SpecialChar"><a href='103grapheme.subx.html#L107'>Default-next-x</a></span> 0/r32/eax
-<span id="L95" class="LineNr"> 95 </span>    8b/-&gt; *(ebp+0x10) 0/r32/eax
-<span id="L96" class="LineNr"> 96 </span>    89/&lt;- *<span class="SpecialChar"><a href='103grapheme.subx.html#L110'>Default-next-y</a></span> 0/r32/eax
-<span id="L97" class="LineNr"> 97 </span><span class="Constant">$set-cursor-position:end</span>:
-<span id="L98" class="LineNr"> 98 </span>    <span class="subxS1Comment"># . restore registers</span>
-<span id="L99" class="LineNr"> 99 </span>    58/pop-to-eax
-<span id="L100" class="LineNr">100 </span>    <span class="subxS1Comment"># . epilogue</span>
-<span id="L101" class="LineNr">101 </span>    89/&lt;- %esp 5/r32/ebp
-<span id="L102" class="LineNr">102 </span>    5d/pop-to-ebp
-<span id="L103" class="LineNr">103 </span>    c3/return
-<span id="L104" class="LineNr">104 </span>
-<span id="L105" class="LineNr">105 </span>== data
-<span id="L106" class="LineNr">106 </span>
-<span id="L107" class="LineNr">107 </span><span class="SpecialChar">Default-next-x</span>:
-<span id="L108" class="LineNr">108 </span>  0/imm32
-<span id="L109" class="LineNr">109 </span>
-<span id="L110" class="LineNr">110 </span><span class="SpecialChar">Default-next-y</span>:
-<span id="L111" class="LineNr">111 </span>  0/imm32
+<span id="L1" class="LineNr">  1 </span><span class="subxComment"># Use the built-in font to draw a grapheme to screen.</span>
+<span id="L2" class="LineNr">  2 </span>
+<span id="L3" class="LineNr">  3 </span>== code
+<span id="L4" class="LineNr">  4 </span>
+<span id="L5" class="LineNr">  5 </span><span class="subxFunction">draw-grapheme</span>:  <span class="subxComment"># screen: (addr screen), g: grapheme, x: int, y: int, color: int</span>
+<span id="L6" class="LineNr">  6 </span>    <span class="subxS1Comment"># . prologue</span>
+<span id="L7" class="LineNr">  7 </span>    55/push-ebp
+<span id="L8" class="LineNr">  8 </span>    89/&lt;- %ebp 4/r32/esp
+<span id="L9" class="LineNr">  9 </span>    <span class="subxS1Comment"># . save registers</span>
+<span id="L10" class="LineNr"> 10 </span>    50/push-eax
+<span id="L11" class="LineNr"> 11 </span>    51/push-ecx
+<span id="L12" class="LineNr"> 12 </span>    52/push-edx
+<span id="L13" class="LineNr"> 13 </span>    53/push-ebx
+<span id="L14" class="LineNr"> 14 </span>    56/push-esi
+<span id="L15" class="LineNr"> 15 </span>    <span class="subxComment"># TODO: support fake screen; we currently assume 'screen' is always 0 (real)</span>
+<span id="L16" class="LineNr"> 16 </span>    <span class="subxComment"># var letter-bitmap/esi = font[g]</span>
+<span id="L17" class="LineNr"> 17 </span>    8b/-&gt; *(ebp+0xc) 6/r32/esi
+<span id="L18" class="LineNr"> 18 </span>    c1 4/subop/shift-left %esi 4/imm8
+<span id="L19" class="LineNr"> 19 </span>    8d/copy-address *(esi+0x8800) 6/r32/esi  <span class="subxComment"># font-start</span>
+<span id="L20" class="LineNr"> 20 </span>    <span class="subxComment"># if (letter-bitmap &gt;= 0x9000) return  # characters beyond ASCII currently not supported</span>
+<span id="L21" class="LineNr"> 21 </span>    81 7/subop/compare %esi 0x9000/imm32
+<span id="L22" class="LineNr"> 22 </span>    7d/jump-if-&gt;= $draw-grapheme:end/disp8
+<span id="L23" class="LineNr"> 23 </span>    <span class="subxComment"># edx = y</span>
+<span id="L24" class="LineNr"> 24 </span>    8b/-&gt; *(ebp+0x14) 2/r32/edx
+<span id="L25" class="LineNr"> 25 </span>    <span class="subxComment"># var ymax/ebx: int = y + 16</span>
+<span id="L26" class="LineNr"> 26 </span>    8b/-&gt; *(ebp+0x14) 3/r32/ebx
+<span id="L27" class="LineNr"> 27 </span>    81 0/subop/add %ebx 0x10/imm32
+<span id="L28" class="LineNr"> 28 </span>    {
+<span id="L29" class="LineNr"> 29 </span>      <span class="subxComment"># if (y &gt;= ymax) break</span>
+<span id="L30" class="LineNr"> 30 </span>      39/compare %edx 3/r32/ebx
+<span id="L31" class="LineNr"> 31 </span>      7d/jump-if-&gt;= <span class="Constant">break</span>/disp8
+<span id="L32" class="LineNr"> 32 </span>      <span class="subxComment"># eax = x + 7</span>
+<span id="L33" class="LineNr"> 33 </span>      8b/-&gt; *(ebp+0x10) 0/r32/eax
+<span id="L34" class="LineNr"> 34 </span>      81 0/subop/add %eax 7/imm32
+<span id="L35" class="LineNr"> 35 </span>      <span class="subxComment"># var xmin/ecx: int = x</span>
+<span id="L36" class="LineNr"> 36 </span>      8b/-&gt; *(ebp+0x10) 1/r32/ecx
+<span id="L37" class="LineNr"> 37 </span>      <span class="subxComment"># var row-bitmap/ebx: int = *letter-bitmap</span>
+<span id="L38" class="LineNr"> 38 </span>      53/push-ebx
+<span id="L39" class="LineNr"> 39 </span>      8b/-&gt; *esi 3/r32/ebx
+<span id="L40" class="LineNr"> 40 </span>      {
+<span id="L41" class="LineNr"> 41 </span>        <span class="subxComment"># if (x &lt; xmin) break</span>
+<span id="L42" class="LineNr"> 42 </span>        39/compare %eax 1/r32/ecx
+<span id="L43" class="LineNr"> 43 </span>        7c/jump-if-&lt; <span class="Constant">break</span>/disp8
+<span id="L44" class="LineNr"> 44 </span>        <span class="subxComment"># shift LSB from row-bitmap into carry flag (CF)</span>
+<span id="L45" class="LineNr"> 45 </span>        c1 5/subop/shift-right-logical %ebx 1/imm8
+<span id="L46" class="LineNr"> 46 </span>        <span class="subxComment"># if LSB, draw a pixel</span>
+<span id="L47" class="LineNr"> 47 </span>        {
+<span id="L48" class="LineNr"> 48 </span>          73/jump-if-not-CF <span class="Constant">break</span>/disp8
+<span id="L49" class="LineNr"> 49 </span>          (<a href='101screen.subx.html#L5'>pixel</a> *(ebp+8) %eax %edx *(ebp+0x18))
+<span id="L50" class="LineNr"> 50 </span>        }
+<span id="L51" class="LineNr"> 51 </span>        <span class="subxComment"># --x</span>
+<span id="L52" class="LineNr"> 52 </span>        48/decrement-eax
+<span id="L53" class="LineNr"> 53 </span>        <span class="subxComment">#</span>
+<span id="L54" class="LineNr"> 54 </span>        eb/jump <span class="Constant">loop</span>/disp8
+<span id="L55" class="LineNr"> 55 </span>      }
+<span id="L56" class="LineNr"> 56 </span>      <span class="subxComment"># reclaim row-bitmap</span>
+<span id="L57" class="LineNr"> 57 </span>      5b/pop-to-ebx
+<span id="L58" class="LineNr"> 58 </span>      <span class="subxComment"># ++y</span>
+<span id="L59" class="LineNr"> 59 </span>      42/increment-edx
+<span id="L60" class="LineNr"> 60 </span>      <span class="subxComment"># next bitmap row</span>
+<span id="L61" class="LineNr"> 61 </span>      46/increment-esi
+<span id="L62" class="LineNr"> 62 </span>      <span class="subxComment">#</span>
+<span id="L63" class="LineNr"> 63 </span>      eb/jump <span class="Constant">loop</span>/disp8
+<span id="L64" class="LineNr"> 64 </span>    }
+<span id="L65" class="LineNr"> 65 </span><span class="Constant">$draw-grapheme:end</span>:
+<span id="L66" class="LineNr"> 66 </span>    <span class="subxS1Comment"># . restore registers</span>
+<span id="L67" class="LineNr"> 67 </span>    5e/pop-to-esi
+<span id="L68" class="LineNr"> 68 </span>    5b/pop-to-ebx
+<span id="L69" class="LineNr"> 69 </span>    5a/pop-to-edx
+<span id="L70" class="LineNr"> 70 </span>    59/pop-to-ecx
+<span id="L71" class="LineNr"> 71 </span>    58/pop-to-eax
+<span id="L72" class="LineNr"> 72 </span>    <span class="subxS1Comment"># . epilogue</span>
+<span id="L73" class="LineNr"> 73 </span>    89/&lt;- %esp 5/r32/ebp
+<span id="L74" class="LineNr"> 74 </span>    5d/pop-to-ebp
+<span id="L75" class="LineNr"> 75 </span>    c3/return
+<span id="L76" class="LineNr"> 76 </span>
+<span id="L77" class="LineNr"> 77 </span><span class="subxFunction">cursor-position</span>:  <span class="subxComment"># screen: (addr screen) -&gt; _/eax: int, _/ecx: int</span>
+<span id="L78" class="LineNr"> 78 </span>    <span class="subxS1Comment"># . prologue</span>
+<span id="L79" class="LineNr"> 79 </span>    55/push-ebp
+<span id="L80" class="LineNr"> 80 </span>    89/&lt;- %ebp 4/r32/esp
+<span id="L81" class="LineNr"> 81 </span>    <span class="subxComment"># TODO: support fake screen; we currently assume 'screen' is always 0 (real)</span>
+<span id="L82" class="LineNr"> 82 </span>    8b/-&gt; *<span class="SpecialChar"><a href='103grapheme.subx.html#L111'>Default-next-x</a></span> 0/r32/eax
+<span id="L83" class="LineNr"> 83 </span>    8b/-&gt; *<span class="SpecialChar"><a href='103grapheme.subx.html#L114'>Default-next-y</a></span> 1/r32/ecx
+<span id="L84" class="LineNr"> 84 </span><span class="Constant">$cursor-position:end</span>:
+<span id="L85" class="LineNr"> 85 </span>    <span class="subxS1Comment"># . epilogue</span>
+<span id="L86" class="LineNr"> 86 </span>    89/&lt;- %esp 5/r32/ebp
+<span id="L87" class="LineNr"> 87 </span>    5d/pop-to-ebp
+<span id="L88" class="LineNr"> 88 </span>    c3/return
+<span id="L89" class="LineNr"> 89 </span>
+<span id="L90" class="LineNr"> 90 </span><span class="subxFunction">set-cursor-position</span>:  <span class="subxComment"># screen: (addr screen), x: int, y: int</span>
+<span id="L91" class="LineNr"> 91 </span>    <span class="subxS1Comment"># . prologue</span>
+<span id="L92" class="LineNr"> 92 </span>    55/push-ebp
+<span id="L93" class="LineNr"> 93 </span>    89/&lt;- %ebp 4/r32/esp
+<span id="L94" class="LineNr"> 94 </span>    <span class="subxS1Comment"># . save registers</span>
+<span id="L95" class="LineNr"> 95 </span>    50/push-eax
+<span id="L96" class="LineNr"> 96 </span>    <span class="subxComment"># TODO: support fake screen; we currently assume 'screen' is always 0 (real)</span>
+<span id="L97" class="LineNr"> 97 </span>    8b/-&gt; *(ebp+0xc) 0/r32/eax
+<span id="L98" class="LineNr"> 98 </span>    89/&lt;- *<span class="SpecialChar"><a href='103grapheme.subx.html#L111'>Default-next-x</a></span> 0/r32/eax
+<span id="L99" class="LineNr"> 99 </span>    8b/-&gt; *(ebp+0x10) 0/r32/eax
+<span id="L100" class="LineNr">100 </span>    89/&lt;- *<span class="SpecialChar"><a href='103grapheme.subx.html#L114'>Default-next-y</a></span> 0/r32/eax
+<span id="L101" class="LineNr">101 </span><span class="Constant">$set-cursor-position:end</span>:
+<span id="L102" class="LineNr">102 </span>    <span class="subxS1Comment"># . restore registers</span>
+<span id="L103" class="LineNr">103 </span>    58/pop-to-eax
+<span id="L104" class="LineNr">104 </span>    <span class="subxS1Comment"># . epilogue</span>
+<span id="L105" class="LineNr">105 </span>    89/&lt;- %esp 5/r32/ebp
+<span id="L106" class="LineNr">106 </span>    5d/pop-to-ebp
+<span id="L107" class="LineNr">107 </span>    c3/return
+<span id="L108" class="LineNr">108 </span>
+<span id="L109" class="LineNr">109 </span>== data
+<span id="L110" class="LineNr">110 </span>
+<span id="L111" class="LineNr">111 </span><span class="SpecialChar">Default-next-x</span>:
+<span id="L112" class="LineNr">112 </span>  0/imm32
+<span id="L113" class="LineNr">113 </span>
+<span id="L114" class="LineNr">114 </span><span class="SpecialChar">Default-next-y</span>:
+<span id="L115" class="LineNr">115 </span>  0/imm32
 </pre>
 </body>
 </html>
diff --git a/html/baremetal/104test.subx.html b/html/baremetal/104test.subx.html
new file mode 100644
index 00000000..ef99acf6
--- /dev/null
+++ b/html/baremetal/104test.subx.html
@@ -0,0 +1,93 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
+<html>
+<head>
+<meta http-equiv="content-type" content="text/html; charset=UTF-8">
+<title>Mu - baremetal/104test.subx</title>
+<meta name="Generator" content="Vim/8.1">
+<meta name="plugin-version" content="vim8.1_v1">
+<meta name="syntax" content="none">
+<meta name="settings" content="number_lines,use_css,pre_wrap,no_foldcolumn,expand_tabs,line_ids,prevent_copy=">
+<meta name="colorscheme" content="minimal-light">
+<style type="text/css">
+<!--
+pre { white-space: pre-wrap; font-family: monospace; color: #000000; background-color: #c6c6c6; }
+body { font-size:12pt; font-family: monospace; color: #000000; background-color: #c6c6c6; }
+a { color:inherit; }
+* { font-size:12pt; font-size: 1em; }
+.SpecialChar { color: #d70000; }
+.subxComment { color: #005faf; }
+.subxS1Comment { color: #0000af; }
+.LineNr { }
+.subxFunction { color: #af5f00; text-decoration: underline; }
+.Constant { color: #008787; }
+-->
+</style>
+
+<script type='text/javascript'>
+<!--
+
+/* function to open any folds containing a jumped-to line before jumping to it */
+function JumpToLine()
+{
+  var lineNum;
+  lineNum = window.location.hash;
+  lineNum = lineNum.substr(1); /* strip off '#' */
+
+  if (lineNum.indexOf('L') == -1) {
+    lineNum = 'L'+lineNum;
+  }
+  var lineElem = document.getElementById(lineNum);
+  /* Always jump to new location even if the line was hidden inside a fold, or
+   * we corrected the raw number to a line ID.
+   */
+  if (lineElem) {
+    lineElem.scrollIntoView(true);
+  }
+  return true;
+}
+if ('onhashchange' in window) {
+  window.onhashchange = JumpToLine;
+}
+
+-->
+</script>
+</head>
+<body onload='JumpToLine();'>
+<a href='https://github.com/akkartik/mu/blob/main/baremetal/104test.subx'>https://github.com/akkartik/mu/blob/main/baremetal/104test.subx</a>
+<pre id='vimCodeElement'>
+<span id="L1" class="LineNr"> 1 </span><span class="subxComment"># Some helpers needed only because Mu doesn't support globals at the moment.</span>
+<span id="L2" class="LineNr"> 2 </span>
+<span id="L3" class="LineNr"> 3 </span>== code
+<span id="L4" class="LineNr"> 4 </span>
+<span id="L5" class="LineNr"> 5 </span><span class="subxFunction">count-test-failure</span>:
+<span id="L6" class="LineNr"> 6 </span>    <span class="subxS1Comment"># . prologue</span>
+<span id="L7" class="LineNr"> 7 </span>    55/push-ebp
+<span id="L8" class="LineNr"> 8 </span>    89/&lt;- %ebp 4/r32/esp
+<span id="L9" class="LineNr"> 9 </span>    <span class="subxComment">#</span>
+<span id="L10" class="LineNr">10 </span>    ff 0/subop/increment *<span class="SpecialChar"><a href='104test.subx.html#L31'>Num-test-failures</a></span>
+<span id="L11" class="LineNr">11 </span><span class="Constant">$count-test-failure:end</span>:
+<span id="L12" class="LineNr">12 </span>    <span class="subxS1Comment"># . epilogue</span>
+<span id="L13" class="LineNr">13 </span>    89/&lt;- %esp 5/r32/ebp
+<span id="L14" class="LineNr">14 </span>    5d/pop-to-ebp
+<span id="L15" class="LineNr">15 </span>    c3/return
+<span id="L16" class="LineNr">16 </span>
+<span id="L17" class="LineNr">17 </span><span class="subxFunction">num-test-failures</span>:  <span class="subxComment"># -&gt; _/eax: int</span>
+<span id="L18" class="LineNr">18 </span>    <span class="subxS1Comment"># . prologue</span>
+<span id="L19" class="LineNr">19 </span>    55/push-ebp
+<span id="L20" class="LineNr">20 </span>    89/&lt;- %ebp 4/r32/esp
+<span id="L21" class="LineNr">21 </span>    <span class="subxComment">#</span>
+<span id="L22" class="LineNr">22 </span>    8b/-&gt; *<span class="SpecialChar"><a href='104test.subx.html#L31'>Num-test-failures</a></span> 0/r32/eax
+<span id="L23" class="LineNr">23 </span><span class="Constant">$num-test-failures:end</span>:
+<span id="L24" class="LineNr">24 </span>    <span class="subxS1Comment"># . epilogue</span>
+<span id="L25" class="LineNr">25 </span>    89/&lt;- %esp 5/r32/ebp
+<span id="L26" class="LineNr">26 </span>    5d/pop-to-ebp
+<span id="L27" class="LineNr">27 </span>    c3/return
+<span id="L28" class="LineNr">28 </span>
+<span id="L29" class="LineNr">29 </span>== data
+<span id="L30" class="LineNr">30 </span>
+<span id="L31" class="LineNr">31 </span><span class="SpecialChar">Num-test-failures</span>:
+<span id="L32" class="LineNr">32 </span>  0/imm32
+</pre>
+</body>
+</html>
+<!-- vim: set foldmethod=manual : -->
diff --git a/html/baremetal/108write.subx.html b/html/baremetal/108write.subx.html
index 608ddb82..5253c1fa 100644
--- a/html/baremetal/108write.subx.html
+++ b/html/baremetal/108write.subx.html
@@ -57,141 +57,142 @@ if ('onhashchange' in window) {
 <body onload='JumpToLine();'>
 <a href='https://github.com/akkartik/mu/blob/main/baremetal/108write.subx'>https://github.com/akkartik/mu/blob/main/baremetal/108write.subx</a>
 <pre id='vimCodeElement'>
-<span id="L1" class="LineNr">  1 </span><span class="subxComment">#   instruction                     effective address                                                   register    displacement    immediate</span>
-<span id="L2" class="LineNr">  2 </span><span class="subxS1Comment"># . op          subop               mod             rm32          base        index         scale       r32</span>
-<span id="L3" class="LineNr">  3 </span><span class="subxS1Comment"># . 1-3 bytes   3 bits              2 bits          3 bits        3 bits      3 bits        2 bits      2 bits      0/1/2/4 bytes   0/1/2/4 bytes</span>
-<span id="L4" class="LineNr">  4 </span>
-<span id="L5" class="LineNr">  5 </span><span class="subxFunction">write</span>:  <span class="subxComment"># f: (addr stream byte), s: (addr array byte)</span>
-<span id="L6" class="LineNr">  6 </span>    <span class="subxS1Comment"># . prologue</span>
-<span id="L7" class="LineNr">  7 </span>    55/push-ebp
-<span id="L8" class="LineNr">  8 </span>    89/copy                         3/mod/direct    5/rm32/ebp   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          4/r32/esp  <span class="Normal"> . </span>             <span class="Normal"> . </span>                <span class="subxComment"># copy esp to ebp</span>
-<span id="L9" class="LineNr">  9 </span>    <span class="subxComment"># if (s == 0) return</span>
-<span id="L10" class="LineNr"> 10 </span>    81          7/subop/compare     1/mod/*+disp8   5/rm32/ebp   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>         <span class="Normal"> . </span>          0xc/disp8       0/imm32           <span class="subxComment"># compare *(ebp+12)</span>
-<span id="L11" class="LineNr"> 11 </span>    74/jump-if-=  $write:end/disp8
-<span id="L12" class="LineNr"> 12 </span>    <span class="subxComment"># TODO: write to file</span>
-<span id="L13" class="LineNr"> 13 </span>    <span class="subxComment"># otherwise, treat 'f' as a stream to append to</span>
-<span id="L14" class="LineNr"> 14 </span>    <span class="subxS1Comment"># . save registers</span>
-<span id="L15" class="LineNr"> 15 </span>    50/push-eax
-<span id="L16" class="LineNr"> 16 </span>    51/push-ecx
-<span id="L17" class="LineNr"> 17 </span>    52/push-edx
-<span id="L18" class="LineNr"> 18 </span>    53/push-ebx
-<span id="L19" class="LineNr"> 19 </span>    <span class="subxComment"># ecx = f</span>
-<span id="L20" class="LineNr"> 20 </span>    8b/copy                         1/mod/*+disp8   5/rm32/ebp   <span class="Normal"> . </span>         <span class="Normal"> . </span>                        1/r32/ecx   8/disp8        <span class="Normal"> . </span>                <span class="subxComment"># copy *(ebp+8) to ecx</span>
-<span id="L21" class="LineNr"> 21 </span>    <span class="subxComment"># edx = f-&gt;write</span>
-<span id="L22" class="LineNr"> 22 </span>    8b/copy                         0/mod/indirect  1/rm32/ecx   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          2/r32/edx  <span class="Normal"> . </span>             <span class="Normal"> . </span>                <span class="subxComment"># copy *ecx to edx</span>
-<span id="L23" class="LineNr"> 23 </span>    <span class="subxComment"># ebx = f-&gt;size</span>
-<span id="L24" class="LineNr"> 24 </span>    8b/copy                         1/mod/*+disp8   1/rm32/ecx   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          3/r32/ebx   8/disp8        <span class="Normal"> . </span>                <span class="subxComment"># copy *(ecx+8) to ebx</span>
-<span id="L25" class="LineNr"> 25 </span>    <span class="subxComment"># eax = _append-3(&amp;f-&gt;data[f-&gt;write], &amp;f-&gt;data[f-&gt;size], s)</span>
-<span id="L26" class="LineNr"> 26 </span>    <span class="subxS2Comment"># . . push s</span>
-<span id="L27" class="LineNr"> 27 </span>    ff          6/subop/push        1/mod/*+disp8   5/rm32/ebp   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>         <span class="Normal"> . </span>          0xc/disp8      <span class="Normal"> . </span>                <span class="subxComment"># push *(ebp+12)</span>
-<span id="L28" class="LineNr"> 28 </span>    <span class="subxS2Comment"># . . push &amp;f-&gt;data[f-&gt;size]</span>
-<span id="L29" class="LineNr"> 29 </span>    8d/copy-address                 1/mod/*+disp8   4/rm32/sib    1/base/ecx  3/index/ebx  <span class="Normal"> . </span>          3/r32/ebx   0xc/disp8      <span class="Normal"> . </span>                <span class="subxComment"># copy ecx+ebx+12 to ebx</span>
-<span id="L30" class="LineNr"> 30 </span>    53/push-ebx
-<span id="L31" class="LineNr"> 31 </span>    <span class="subxS2Comment"># . . push &amp;f-&gt;data[f-&gt;write]</span>
-<span id="L32" class="LineNr"> 32 </span>    8d/copy-address                 1/mod/*+disp8   4/rm32/sib    1/base/ecx  2/index/edx  <span class="Normal"> . </span>          3/r32/ebx   0xc/disp8      <span class="Normal"> . </span>                <span class="subxComment"># copy ecx+edx+12 to ebx</span>
-<span id="L33" class="LineNr"> 33 </span>    53/push-ebx
-<span id="L34" class="LineNr"> 34 </span>    <span class="subxS2Comment"># . . call</span>
-<span id="L35" class="LineNr"> 35 </span>    e8/call  <a href='108write.subx.html#L54'>_append-3</a>/disp32
-<span id="L36" class="LineNr"> 36 </span>    <span class="subxS2Comment"># . . discard args</span>
-<span id="L37" class="LineNr"> 37 </span>    81          0/subop/add         3/mod/direct    4/rm32/esp   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>         <span class="Normal"> . </span>         <span class="Normal"> . </span>              0xc/imm32         <span class="subxComment"># add to esp</span>
-<span id="L38" class="LineNr"> 38 </span>    <span class="subxComment"># f-&gt;write += eax</span>
-<span id="L39" class="LineNr"> 39 </span>    01/add                          0/mod/indirect  1/rm32/ecx   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          0/r32/eax  <span class="Normal"> . </span>             <span class="Normal"> . </span>                <span class="subxComment"># add eax to *ecx</span>
-<span id="L40" class="LineNr"> 40 </span>    <span class="subxS1Comment"># . restore registers</span>
-<span id="L41" class="LineNr"> 41 </span>    5b/pop-to-ebx
-<span id="L42" class="LineNr"> 42 </span>    5a/pop-to-edx
-<span id="L43" class="LineNr"> 43 </span>    59/pop-to-ecx
-<span id="L44" class="LineNr"> 44 </span>    58/pop-to-eax
-<span id="L45" class="LineNr"> 45 </span><span class="Constant">$write:end</span>:
-<span id="L46" class="LineNr"> 46 </span>    <span class="subxS1Comment"># . epilogue</span>
-<span id="L47" class="LineNr"> 47 </span>    89/copy                         3/mod/direct    4/rm32/esp   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          5/r32/ebp  <span class="Normal"> . </span>             <span class="Normal"> . </span>                <span class="subxComment"># copy ebp to esp</span>
-<span id="L48" class="LineNr"> 48 </span>    5d/pop-to-ebp
-<span id="L49" class="LineNr"> 49 </span>    c3/return
-<span id="L50" class="LineNr"> 50 </span>
-<span id="L51" class="LineNr"> 51 </span><span class="subxComment"># TODO: bring in tests once we have check-ints-equal</span>
-<span id="L52" class="LineNr"> 52 </span>
-<span id="L53" class="LineNr"> 53 </span><span class="subxComment"># 3-argument variant of _append</span>
-<span id="L54" class="LineNr"> 54 </span><span class="subxMinorFunction">_append-3</span>:  <span class="subxComment"># out: (addr byte), outend: (addr byte), s: (addr array byte) -&gt; num_bytes_appended/eax</span>
-<span id="L55" class="LineNr"> 55 </span>    <span class="subxS1Comment"># . prologue</span>
-<span id="L56" class="LineNr"> 56 </span>    55/push-ebp
-<span id="L57" class="LineNr"> 57 </span>    89/copy                         3/mod/direct    5/rm32/ebp   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          4/r32/esp  <span class="Normal"> . </span>             <span class="Normal"> . </span>                <span class="subxComment"># copy esp to ebp</span>
-<span id="L58" class="LineNr"> 58 </span>    <span class="subxS1Comment"># . save registers</span>
-<span id="L59" class="LineNr"> 59 </span>    51/push-ecx
-<span id="L60" class="LineNr"> 60 </span>    <span class="subxComment"># eax = _append-4(out, outend, &amp;s-&gt;data[0], &amp;s-&gt;data[s-&gt;size])</span>
-<span id="L61" class="LineNr"> 61 </span>    <span class="subxS2Comment"># . . push &amp;s-&gt;data[s-&gt;size]</span>
-<span id="L62" class="LineNr"> 62 </span>    8b/copy                         1/mod/*+disp8   5/rm32/ebp   <span class="Normal"> . </span>         <span class="Normal"> . </span>                        0/r32/eax   0x10/disp8     <span class="Normal"> . </span>                <span class="subxComment"># copy *(ebp+16) to eax</span>
-<span id="L63" class="LineNr"> 63 </span>    8b/copy                         0/mod/indirect  0/rm32/eax   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          1/r32/ecx  <span class="Normal"> . </span>             <span class="Normal"> . </span>                <span class="subxComment"># copy *eax to ecx</span>
-<span id="L64" class="LineNr"> 64 </span>    8d/copy-address                 1/mod/*+disp8   4/rm32/sib    0/base/eax  1/index/ecx  <span class="Normal"> . </span>          1/r32/ecx   4/disp8        <span class="Normal"> . </span>                <span class="subxComment"># copy eax+ecx+4 to ecx</span>
-<span id="L65" class="LineNr"> 65 </span>    51/push-ecx
-<span id="L66" class="LineNr"> 66 </span>    <span class="subxS2Comment"># . . push &amp;s-&gt;data[0]</span>
-<span id="L67" class="LineNr"> 67 </span>    8d/copy-address                 1/mod/*+disp8   0/rm32/eax   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          1/r32/ecx   4/disp8        <span class="Normal"> . </span>                <span class="subxComment"># copy eax+4 to ecx</span>
-<span id="L68" class="LineNr"> 68 </span>    51/push-ecx
-<span id="L69" class="LineNr"> 69 </span>    <span class="subxS2Comment"># . . push outend</span>
-<span id="L70" class="LineNr"> 70 </span>    ff          6/subop/push        1/mod/*+disp8   5/rm32/ebp   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>         <span class="Normal"> . </span>          0xc/disp8      <span class="Normal"> . </span>                <span class="subxComment"># push *(ebp+12)</span>
-<span id="L71" class="LineNr"> 71 </span>    <span class="subxS2Comment"># . . push out</span>
-<span id="L72" class="LineNr"> 72 </span>    ff          6/subop/push        1/mod/*+disp8   5/rm32/ebp   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>         <span class="Normal"> . </span>          8/disp8        <span class="Normal"> . </span>                <span class="subxComment"># push *(ebp+8)</span>
-<span id="L73" class="LineNr"> 73 </span>    <span class="subxS2Comment"># . . call</span>
-<span id="L74" class="LineNr"> 74 </span>    e8/call  <a href='108write.subx.html#L86'>_append-4</a>/disp32
-<span id="L75" class="LineNr"> 75 </span>    <span class="subxS2Comment"># . . discard args</span>
-<span id="L76" class="LineNr"> 76 </span>    81          0/subop/add         3/mod/direct    4/rm32/esp   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>         <span class="Normal"> . </span>         <span class="Normal"> . </span>              0x10/imm32        <span class="subxComment"># add to esp</span>
-<span id="L77" class="LineNr"> 77 </span><span class="Constant">$_append-3:end</span>:
-<span id="L78" class="LineNr"> 78 </span>    <span class="subxS1Comment"># . restore registers</span>
-<span id="L79" class="LineNr"> 79 </span>    59/pop-to-ecx
-<span id="L80" class="LineNr"> 80 </span>    <span class="subxS1Comment"># . epilogue</span>
-<span id="L81" class="LineNr"> 81 </span>    89/copy                         3/mod/direct    4/rm32/esp   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          5/r32/ebp  <span class="Normal"> . </span>             <span class="Normal"> . </span>                <span class="subxComment"># copy ebp to esp</span>
-<span id="L82" class="LineNr"> 82 </span>    5d/pop-to-ebp
-<span id="L83" class="LineNr"> 83 </span>    c3/return
-<span id="L84" class="LineNr"> 84 </span>
-<span id="L85" class="LineNr"> 85 </span><span class="subxComment"># 4-argument variant of _append</span>
-<span id="L86" class="LineNr"> 86 </span><span class="subxMinorFunction">_append-4</span>:  <span class="subxComment"># out: (addr byte), outend: (addr byte), in: (addr byte), inend: (addr byte) -&gt; num_bytes_appended/eax: int</span>
-<span id="L87" class="LineNr"> 87 </span>    <span class="subxS1Comment"># . prologue</span>
-<span id="L88" class="LineNr"> 88 </span>    55/push-ebp
-<span id="L89" class="LineNr"> 89 </span>    89/copy                         3/mod/direct    5/rm32/ebp   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          4/r32/esp  <span class="Normal"> . </span>             <span class="Normal"> . </span>                <span class="subxComment"># copy esp to ebp</span>
-<span id="L90" class="LineNr"> 90 </span>    <span class="subxS1Comment"># . save registers</span>
-<span id="L91" class="LineNr"> 91 </span>    51/push-ecx
-<span id="L92" class="LineNr"> 92 </span>    52/push-edx
-<span id="L93" class="LineNr"> 93 </span>    53/push-ebx
-<span id="L94" class="LineNr"> 94 </span>    56/push-esi
-<span id="L95" class="LineNr"> 95 </span>    57/push-edi
-<span id="L96" class="LineNr"> 96 </span>    <span class="subxComment"># num_bytes_appended = 0</span>
-<span id="L97" class="LineNr"> 97 </span>    b8/copy-to-eax  0/imm32
-<span id="L98" class="LineNr"> 98 </span>    <span class="subxComment"># edi = out</span>
-<span id="L99" class="LineNr"> 99 </span>    8b/copy                         1/mod/*+disp8   5/rm32/ebp   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          7/r32/edi   8/disp8        <span class="Normal"> . </span>                <span class="subxComment"># copy *(ebp+8) to edi</span>
-<span id="L100" class="LineNr">100 </span>    <span class="subxComment"># edx = outend</span>
-<span id="L101" class="LineNr">101 </span>    8b/copy                         1/mod/*+disp8   5/rm32/ebp   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          2/r32/edx   0xc/disp8      <span class="Normal"> . </span>                <span class="subxComment"># copy *(ebp+12) to edx</span>
-<span id="L102" class="LineNr">102 </span>    <span class="subxComment"># esi = in</span>
-<span id="L103" class="LineNr">103 </span>    8b/copy                         1/mod/*+disp8   5/rm32/ebp   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          6/r32/esi   0x10/disp8     <span class="Normal"> . </span>                <span class="subxComment"># copy *(ebp+16) to esi</span>
-<span id="L104" class="LineNr">104 </span>    <span class="subxComment"># ecx = inend</span>
-<span id="L105" class="LineNr">105 </span>    8b/copy                         1/mod/*+disp8   5/rm32/ebp   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          1/r32/ecx   0x14/disp8     <span class="Normal"> . </span>                <span class="subxComment"># copy *(ebp+20) to ecx</span>
-<span id="L106" class="LineNr">106 </span><span class="Constant">$_append-4:loop</span>:
-<span id="L107" class="LineNr">107 </span>    <span class="subxComment"># if (in &gt;= inend) break</span>
-<span id="L108" class="LineNr">108 </span>    39/compare                      3/mod/direct    6/rm32/esi   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          1/r32/ecx  <span class="Normal"> . </span>             <span class="Normal"> . </span>                <span class="subxComment"># compare esi with ecx</span>
-<span id="L109" class="LineNr">109 </span>    73/jump-if-addr&gt;=  $_append-4:end/disp8
-<span id="L110" class="LineNr">110 </span>    <span class="subxComment"># if (out &gt;= outend) abort  # just to catch test failures fast</span>
-<span id="L111" class="LineNr">111 </span>    39/compare                      3/mod/direct    7/rm32/edi   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          2/r32/edx  <span class="Normal"> . </span>             <span class="Normal"> . </span>                <span class="subxComment"># compare edi with edx</span>
-<span id="L112" class="LineNr">112 </span>    73/jump-if-addr&gt;=  $_append-4:end/disp8  <span class="subxComment"># TODO: abort</span>
-<span id="L113" class="LineNr">113 </span>    <span class="subxComment"># *out = *in</span>
-<span id="L114" class="LineNr">114 </span>    8a/copy-byte                    0/mod/indirect  6/rm32/esi   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          3/r32/BL   <span class="Normal"> . </span>             <span class="Normal"> . </span>                <span class="subxComment"># copy byte at *esi to BL</span>
-<span id="L115" class="LineNr">115 </span>    88/copy-byte                    0/mod/indirect  7/rm32/edi   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          3/r32/BL   <span class="Normal"> . </span>             <span class="Normal"> . </span>                <span class="subxComment"># copy byte at BL to *edi</span>
-<span id="L116" class="LineNr">116 </span>    <span class="subxComment"># ++num_bytes_appended</span>
-<span id="L117" class="LineNr">117 </span>    40/increment-eax
-<span id="L118" class="LineNr">118 </span>    <span class="subxComment"># ++in</span>
-<span id="L119" class="LineNr">119 </span>    46/increment-esi
-<span id="L120" class="LineNr">120 </span>    <span class="subxComment"># ++out</span>
-<span id="L121" class="LineNr">121 </span>    47/increment-edi
-<span id="L122" class="LineNr">122 </span>    eb/jump  $_append-4:<span class="Constant">loop</span>/disp8
-<span id="L123" class="LineNr">123 </span><span class="Constant">$_append-4:end</span>:
-<span id="L124" class="LineNr">124 </span>    <span class="subxS1Comment"># . restore registers</span>
-<span id="L125" class="LineNr">125 </span>    5f/pop-to-edi
-<span id="L126" class="LineNr">126 </span>    5e/pop-to-esi
-<span id="L127" class="LineNr">127 </span>    5b/pop-to-ebx
-<span id="L128" class="LineNr">128 </span>    5a/pop-to-edx
-<span id="L129" class="LineNr">129 </span>    59/pop-to-ecx
-<span id="L130" class="LineNr">130 </span>    <span class="subxS1Comment"># . epilogue</span>
-<span id="L131" class="LineNr">131 </span>    89/copy                         3/mod/direct    4/rm32/esp   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          5/r32/ebp  <span class="Normal"> . </span>             <span class="Normal"> . </span>                <span class="subxComment"># copy ebp to esp</span>
-<span id="L132" class="LineNr">132 </span>    5d/pop-to-ebp
-<span id="L133" class="LineNr">133 </span>    c3/return
-<span id="L134" class="LineNr">134 </span>
-<span id="L135" class="LineNr">135 </span><span class="subxS2Comment"># . . vim&#0058;nowrap:textwidth=0</span>
+<span id="L1" class="LineNr">  1 </span>== code
+<span id="L2" class="LineNr">  2 </span><span class="subxComment">#   instruction                     effective address                                                   register    displacement    immediate</span>
+<span id="L3" class="LineNr">  3 </span><span class="subxS1Comment"># . op          subop               mod             rm32          base        index         scale       r32</span>
+<span id="L4" class="LineNr">  4 </span><span class="subxS1Comment"># . 1-3 bytes   3 bits              2 bits          3 bits        3 bits      3 bits        2 bits      2 bits      0/1/2/4 bytes   0/1/2/4 bytes</span>
+<span id="L5" class="LineNr">  5 </span>
+<span id="L6" class="LineNr">  6 </span><span class="subxFunction">write</span>:  <span class="subxComment"># f: (addr stream byte), s: (addr array byte)</span>
+<span id="L7" class="LineNr">  7 </span>    <span class="subxS1Comment"># . prologue</span>
+<span id="L8" class="LineNr">  8 </span>    55/push-ebp
+<span id="L9" class="LineNr">  9 </span>    89/copy                         3/mod/direct    5/rm32/ebp   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          4/r32/esp  <span class="Normal"> . </span>             <span class="Normal"> . </span>                <span class="subxComment"># copy esp to ebp</span>
+<span id="L10" class="LineNr"> 10 </span>    <span class="subxComment"># if (s == 0) return</span>
+<span id="L11" class="LineNr"> 11 </span>    81          7/subop/compare     1/mod/*+disp8   5/rm32/ebp   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>         <span class="Normal"> . </span>          0xc/disp8       0/imm32           <span class="subxComment"># compare *(ebp+12)</span>
+<span id="L12" class="LineNr"> 12 </span>    74/jump-if-=  $write:end/disp8
+<span id="L13" class="LineNr"> 13 </span>    <span class="subxComment"># TODO: write to file</span>
+<span id="L14" class="LineNr"> 14 </span>    <span class="subxComment"># otherwise, treat 'f' as a stream to append to</span>
+<span id="L15" class="LineNr"> 15 </span>    <span class="subxS1Comment"># . save registers</span>
+<span id="L16" class="LineNr"> 16 </span>    50/push-eax
+<span id="L17" class="LineNr"> 17 </span>    51/push-ecx
+<span id="L18" class="LineNr"> 18 </span>    52/push-edx
+<span id="L19" class="LineNr"> 19 </span>    53/push-ebx
+<span id="L20" class="LineNr"> 20 </span>    <span class="subxComment"># ecx = f</span>
+<span id="L21" class="LineNr"> 21 </span>    8b/copy                         1/mod/*+disp8   5/rm32/ebp   <span class="Normal"> . </span>         <span class="Normal"> . </span>                        1/r32/ecx   8/disp8        <span class="Normal"> . </span>                <span class="subxComment"># copy *(ebp+8) to ecx</span>
+<span id="L22" class="LineNr"> 22 </span>    <span class="subxComment"># edx = f-&gt;write</span>
+<span id="L23" class="LineNr"> 23 </span>    8b/copy                         0/mod/indirect  1/rm32/ecx   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          2/r32/edx  <span class="Normal"> . </span>             <span class="Normal"> . </span>                <span class="subxComment"># copy *ecx to edx</span>
+<span id="L24" class="LineNr"> 24 </span>    <span class="subxComment"># ebx = f-&gt;size</span>
+<span id="L25" class="LineNr"> 25 </span>    8b/copy                         1/mod/*+disp8   1/rm32/ecx   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          3/r32/ebx   8/disp8        <span class="Normal"> . </span>                <span class="subxComment"># copy *(ecx+8) to ebx</span>
+<span id="L26" class="LineNr"> 26 </span>    <span class="subxComment"># eax = _append-3(&amp;f-&gt;data[f-&gt;write], &amp;f-&gt;data[f-&gt;size], s)</span>
+<span id="L27" class="LineNr"> 27 </span>    <span class="subxS2Comment"># . . push s</span>
+<span id="L28" class="LineNr"> 28 </span>    ff          6/subop/push        1/mod/*+disp8   5/rm32/ebp   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>         <span class="Normal"> . </span>          0xc/disp8      <span class="Normal"> . </span>                <span class="subxComment"># push *(ebp+12)</span>
+<span id="L29" class="LineNr"> 29 </span>    <span class="subxS2Comment"># . . push &amp;f-&gt;data[f-&gt;size]</span>
+<span id="L30" class="LineNr"> 30 </span>    8d/copy-address                 1/mod/*+disp8   4/rm32/sib    1/base/ecx  3/index/ebx  <span class="Normal"> . </span>          3/r32/ebx   0xc/disp8      <span class="Normal"> . </span>                <span class="subxComment"># copy ecx+ebx+12 to ebx</span>
+<span id="L31" class="LineNr"> 31 </span>    53/push-ebx
+<span id="L32" class="LineNr"> 32 </span>    <span class="subxS2Comment"># . . push &amp;f-&gt;data[f-&gt;write]</span>
+<span id="L33" class="LineNr"> 33 </span>    8d/copy-address                 1/mod/*+disp8   4/rm32/sib    1/base/ecx  2/index/edx  <span class="Normal"> . </span>          3/r32/ebx   0xc/disp8      <span class="Normal"> . </span>                <span class="subxComment"># copy ecx+edx+12 to ebx</span>
+<span id="L34" class="LineNr"> 34 </span>    53/push-ebx
+<span id="L35" class="LineNr"> 35 </span>    <span class="subxS2Comment"># . . call</span>
+<span id="L36" class="LineNr"> 36 </span>    e8/call  <a href='108write.subx.html#L55'>_append-3</a>/disp32
+<span id="L37" class="LineNr"> 37 </span>    <span class="subxS2Comment"># . . discard args</span>
+<span id="L38" class="LineNr"> 38 </span>    81          0/subop/add         3/mod/direct    4/rm32/esp   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>         <span class="Normal"> . </span>         <span class="Normal"> . </span>              0xc/imm32         <span class="subxComment"># add to esp</span>
+<span id="L39" class="LineNr"> 39 </span>    <span class="subxComment"># f-&gt;write += eax</span>
+<span id="L40" class="LineNr"> 40 </span>    01/add                          0/mod/indirect  1/rm32/ecx   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          0/r32/eax  <span class="Normal"> . </span>             <span class="Normal"> . </span>                <span class="subxComment"># add eax to *ecx</span>
+<span id="L41" class="LineNr"> 41 </span>    <span class="subxS1Comment"># . restore registers</span>
+<span id="L42" class="LineNr"> 42 </span>    5b/pop-to-ebx
+<span id="L43" class="LineNr"> 43 </span>    5a/pop-to-edx
+<span id="L44" class="LineNr"> 44 </span>    59/pop-to-ecx
+<span id="L45" class="LineNr"> 45 </span>    58/pop-to-eax
+<span id="L46" class="LineNr"> 46 </span><span class="Constant">$write:end</span>:
+<span id="L47" class="LineNr"> 47 </span>    <span class="subxS1Comment"># . epilogue</span>
+<span id="L48" class="LineNr"> 48 </span>    89/copy                         3/mod/direct    4/rm32/esp   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          5/r32/ebp  <span class="Normal"> . </span>             <span class="Normal"> . </span>                <span class="subxComment"># copy ebp to esp</span>
+<span id="L49" class="LineNr"> 49 </span>    5d/pop-to-ebp
+<span id="L50" class="LineNr"> 50 </span>    c3/return
+<span id="L51" class="LineNr"> 51 </span>
+<span id="L52" class="LineNr"> 52 </span><span class="subxComment"># TODO: bring in tests once we have check-ints-equal</span>
+<span id="L53" class="LineNr"> 53 </span>
+<span id="L54" class="LineNr"> 54 </span><span class="subxComment"># 3-argument variant of _append</span>
+<span id="L55" class="LineNr"> 55 </span><span class="subxMinorFunction">_append-3</span>:  <span class="subxComment"># out: (addr byte), outend: (addr byte), s: (addr array byte) -&gt; num_bytes_appended/eax</span>
+<span id="L56" class="LineNr"> 56 </span>    <span class="subxS1Comment"># . prologue</span>
+<span id="L57" class="LineNr"> 57 </span>    55/push-ebp
+<span id="L58" class="LineNr"> 58 </span>    89/copy                         3/mod/direct    5/rm32/ebp   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          4/r32/esp  <span class="Normal"> . </span>             <span class="Normal"> . </span>                <span class="subxComment"># copy esp to ebp</span>
+<span id="L59" class="LineNr"> 59 </span>    <span class="subxS1Comment"># . save registers</span>
+<span id="L60" class="LineNr"> 60 </span>    51/push-ecx
+<span id="L61" class="LineNr"> 61 </span>    <span class="subxComment"># eax = _append-4(out, outend, &amp;s-&gt;data[0], &amp;s-&gt;data[s-&gt;size])</span>
+<span id="L62" class="LineNr"> 62 </span>    <span class="subxS2Comment"># . . push &amp;s-&gt;data[s-&gt;size]</span>
+<span id="L63" class="LineNr"> 63 </span>    8b/copy                         1/mod/*+disp8   5/rm32/ebp   <span class="Normal"> . </span>         <span class="Normal"> . </span>                        0/r32/eax   0x10/disp8     <span class="Normal"> . </span>                <span class="subxComment"># copy *(ebp+16) to eax</span>
+<span id="L64" class="LineNr"> 64 </span>    8b/copy                         0/mod/indirect  0/rm32/eax   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          1/r32/ecx  <span class="Normal"> . </span>             <span class="Normal"> . </span>                <span class="subxComment"># copy *eax to ecx</span>
+<span id="L65" class="LineNr"> 65 </span>    8d/copy-address                 1/mod/*+disp8   4/rm32/sib    0/base/eax  1/index/ecx  <span class="Normal"> . </span>          1/r32/ecx   4/disp8        <span class="Normal"> . </span>                <span class="subxComment"># copy eax+ecx+4 to ecx</span>
+<span id="L66" class="LineNr"> 66 </span>    51/push-ecx
+<span id="L67" class="LineNr"> 67 </span>    <span class="subxS2Comment"># . . push &amp;s-&gt;data[0]</span>
+<span id="L68" class="LineNr"> 68 </span>    8d/copy-address                 1/mod/*+disp8   0/rm32/eax   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          1/r32/ecx   4/disp8        <span class="Normal"> . </span>                <span class="subxComment"># copy eax+4 to ecx</span>
+<span id="L69" class="LineNr"> 69 </span>    51/push-ecx
+<span id="L70" class="LineNr"> 70 </span>    <span class="subxS2Comment"># . . push outend</span>
+<span id="L71" class="LineNr"> 71 </span>    ff          6/subop/push        1/mod/*+disp8   5/rm32/ebp   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>         <span class="Normal"> . </span>          0xc/disp8      <span class="Normal"> . </span>                <span class="subxComment"># push *(ebp+12)</span>
+<span id="L72" class="LineNr"> 72 </span>    <span class="subxS2Comment"># . . push out</span>
+<span id="L73" class="LineNr"> 73 </span>    ff          6/subop/push        1/mod/*+disp8   5/rm32/ebp   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>         <span class="Normal"> . </span>          8/disp8        <span class="Normal"> . </span>                <span class="subxComment"># push *(ebp+8)</span>
+<span id="L74" class="LineNr"> 74 </span>    <span class="subxS2Comment"># . . call</span>
+<span id="L75" class="LineNr"> 75 </span>    e8/call  <a href='108write.subx.html#L87'>_append-4</a>/disp32
+<span id="L76" class="LineNr"> 76 </span>    <span class="subxS2Comment"># . . discard args</span>
+<span id="L77" class="LineNr"> 77 </span>    81          0/subop/add         3/mod/direct    4/rm32/esp   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>         <span class="Normal"> . </span>         <span class="Normal"> . </span>              0x10/imm32        <span class="subxComment"># add to esp</span>
+<span id="L78" class="LineNr"> 78 </span><span class="Constant">$_append-3:end</span>:
+<span id="L79" class="LineNr"> 79 </span>    <span class="subxS1Comment"># . restore registers</span>
+<span id="L80" class="LineNr"> 80 </span>    59/pop-to-ecx
+<span id="L81" class="LineNr"> 81 </span>    <span class="subxS1Comment"># . epilogue</span>
+<span id="L82" class="LineNr"> 82 </span>    89/copy                         3/mod/direct    4/rm32/esp   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          5/r32/ebp  <span class="Normal"> . </span>             <span class="Normal"> . </span>                <span class="subxComment"># copy ebp to esp</span>
+<span id="L83" class="LineNr"> 83 </span>    5d/pop-to-ebp
+<span id="L84" class="LineNr"> 84 </span>    c3/return
+<span id="L85" class="LineNr"> 85 </span>
+<span id="L86" class="LineNr"> 86 </span><span class="subxComment"># 4-argument variant of _append</span>
+<span id="L87" class="LineNr"> 87 </span><span class="subxMinorFunction">_append-4</span>:  <span class="subxComment"># out: (addr byte), outend: (addr byte), in: (addr byte), inend: (addr byte) -&gt; num_bytes_appended/eax: int</span>
+<span id="L88" class="LineNr"> 88 </span>    <span class="subxS1Comment"># . prologue</span>
+<span id="L89" class="LineNr"> 89 </span>    55/push-ebp
+<span id="L90" class="LineNr"> 90 </span>    89/copy                         3/mod/direct    5/rm32/ebp   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          4/r32/esp  <span class="Normal"> . </span>             <span class="Normal"> . </span>                <span class="subxComment"># copy esp to ebp</span>
+<span id="L91" class="LineNr"> 91 </span>    <span class="subxS1Comment"># . save registers</span>
+<span id="L92" class="LineNr"> 92 </span>    51/push-ecx
+<span id="L93" class="LineNr"> 93 </span>    52/push-edx
+<span id="L94" class="LineNr"> 94 </span>    53/push-ebx
+<span id="L95" class="LineNr"> 95 </span>    56/push-esi
+<span id="L96" class="LineNr"> 96 </span>    57/push-edi
+<span id="L97" class="LineNr"> 97 </span>    <span class="subxComment"># num_bytes_appended = 0</span>
+<span id="L98" class="LineNr"> 98 </span>    b8/copy-to-eax  0/imm32
+<span id="L99" class="LineNr"> 99 </span>    <span class="subxComment"># edi = out</span>
+<span id="L100" class="LineNr">100 </span>    8b/copy                         1/mod/*+disp8   5/rm32/ebp   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          7/r32/edi   8/disp8        <span class="Normal"> . </span>                <span class="subxComment"># copy *(ebp+8) to edi</span>
+<span id="L101" class="LineNr">101 </span>    <span class="subxComment"># edx = outend</span>
+<span id="L102" class="LineNr">102 </span>    8b/copy                         1/mod/*+disp8   5/rm32/ebp   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          2/r32/edx   0xc/disp8      <span class="Normal"> . </span>                <span class="subxComment"># copy *(ebp+12) to edx</span>
+<span id="L103" class="LineNr">103 </span>    <span class="subxComment"># esi = in</span>
+<span id="L104" class="LineNr">104 </span>    8b/copy                         1/mod/*+disp8   5/rm32/ebp   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          6/r32/esi   0x10/disp8     <span class="Normal"> . </span>                <span class="subxComment"># copy *(ebp+16) to esi</span>
+<span id="L105" class="LineNr">105 </span>    <span class="subxComment"># ecx = inend</span>
+<span id="L106" class="LineNr">106 </span>    8b/copy                         1/mod/*+disp8   5/rm32/ebp   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          1/r32/ecx   0x14/disp8     <span class="Normal"> . </span>                <span class="subxComment"># copy *(ebp+20) to ecx</span>
+<span id="L107" class="LineNr">107 </span><span class="Constant">$_append-4:loop</span>:
+<span id="L108" class="LineNr">108 </span>    <span class="subxComment"># if (in &gt;= inend) break</span>
+<span id="L109" class="LineNr">109 </span>    39/compare                      3/mod/direct    6/rm32/esi   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          1/r32/ecx  <span class="Normal"> . </span>             <span class="Normal"> . </span>                <span class="subxComment"># compare esi with ecx</span>
+<span id="L110" class="LineNr">110 </span>    73/jump-if-addr&gt;=  $_append-4:end/disp8
+<span id="L111" class="LineNr">111 </span>    <span class="subxComment"># if (out &gt;= outend) abort  # just to catch test failures fast</span>
+<span id="L112" class="LineNr">112 </span>    39/compare                      3/mod/direct    7/rm32/edi   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          2/r32/edx  <span class="Normal"> . </span>             <span class="Normal"> . </span>                <span class="subxComment"># compare edi with edx</span>
+<span id="L113" class="LineNr">113 </span>    73/jump-if-addr&gt;=  $_append-4:end/disp8  <span class="subxComment"># TODO: abort</span>
+<span id="L114" class="LineNr">114 </span>    <span class="subxComment"># *out = *in</span>
+<span id="L115" class="LineNr">115 </span>    8a/copy-byte                    0/mod/indirect  6/rm32/esi   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          3/r32/BL   <span class="Normal"> . </span>             <span class="Normal"> . </span>                <span class="subxComment"># copy byte at *esi to BL</span>
+<span id="L116" class="LineNr">116 </span>    88/copy-byte                    0/mod/indirect  7/rm32/edi   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          3/r32/BL   <span class="Normal"> . </span>             <span class="Normal"> . </span>                <span class="subxComment"># copy byte at BL to *edi</span>
+<span id="L117" class="LineNr">117 </span>    <span class="subxComment"># ++num_bytes_appended</span>
+<span id="L118" class="LineNr">118 </span>    40/increment-eax
+<span id="L119" class="LineNr">119 </span>    <span class="subxComment"># ++in</span>
+<span id="L120" class="LineNr">120 </span>    46/increment-esi
+<span id="L121" class="LineNr">121 </span>    <span class="subxComment"># ++out</span>
+<span id="L122" class="LineNr">122 </span>    47/increment-edi
+<span id="L123" class="LineNr">123 </span>    eb/jump  $_append-4:<span class="Constant">loop</span>/disp8
+<span id="L124" class="LineNr">124 </span><span class="Constant">$_append-4:end</span>:
+<span id="L125" class="LineNr">125 </span>    <span class="subxS1Comment"># . restore registers</span>
+<span id="L126" class="LineNr">126 </span>    5f/pop-to-edi
+<span id="L127" class="LineNr">127 </span>    5e/pop-to-esi
+<span id="L128" class="LineNr">128 </span>    5b/pop-to-ebx
+<span id="L129" class="LineNr">129 </span>    5a/pop-to-edx
+<span id="L130" class="LineNr">130 </span>    59/pop-to-ecx
+<span id="L131" class="LineNr">131 </span>    <span class="subxS1Comment"># . epilogue</span>
+<span id="L132" class="LineNr">132 </span>    89/copy                         3/mod/direct    4/rm32/esp   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          5/r32/ebp  <span class="Normal"> . </span>             <span class="Normal"> . </span>                <span class="subxComment"># copy ebp to esp</span>
+<span id="L133" class="LineNr">133 </span>    5d/pop-to-ebp
+<span id="L134" class="LineNr">134 </span>    c3/return
+<span id="L135" class="LineNr">135 </span>
+<span id="L136" class="LineNr">136 </span><span class="subxS2Comment"># . . vim&#0058;nowrap:textwidth=0</span>
 </pre>
 </body>
 </html>
diff --git a/html/baremetal/112read-byte.subx.html b/html/baremetal/112read-byte.subx.html
index 06271ee0..553a564c 100644
--- a/html/baremetal/112read-byte.subx.html
+++ b/html/baremetal/112read-byte.subx.html
@@ -56,43 +56,44 @@ if ('onhashchange' in window) {
 <body onload='JumpToLine();'>
 <a href='https://github.com/akkartik/mu/blob/main/baremetal/112read-byte.subx'>https://github.com/akkartik/mu/blob/main/baremetal/112read-byte.subx</a>
 <pre id='vimCodeElement'>
-<span id="L1" class="LineNr"> 1 </span><span class="subxComment">#   instruction                     effective address                                                   register    displacement    immediate</span>
-<span id="L2" class="LineNr"> 2 </span><span class="subxS1Comment"># . op          subop               mod             rm32          base        index         scale       r32</span>
-<span id="L3" class="LineNr"> 3 </span><span class="subxS1Comment"># . 1-3 bytes   3 bits              2 bits          3 bits        3 bits      3 bits        2 bits      2 bits      0/1/2/4 bytes   0/1/2/4 bytes</span>
-<span id="L4" class="LineNr"> 4 </span>
-<span id="L5" class="LineNr"> 5 </span><span class="subxComment"># TODO: read-byte-buffered</span>
-<span id="L6" class="LineNr"> 6 </span>
-<span id="L7" class="LineNr"> 7 </span><span class="subxComment"># Return next byte value in eax, with top 3 bytes cleared.</span>
-<span id="L8" class="LineNr"> 8 </span><span class="subxComment"># Abort on reaching end of stream.</span>
-<span id="L9" class="LineNr"> 9 </span><span class="subxFunction">read-byte</span>:  <span class="subxComment"># s: (addr stream byte) -&gt; result/eax: byte</span>
-<span id="L10" class="LineNr">10 </span>    <span class="subxS1Comment"># . prologue</span>
-<span id="L11" class="LineNr">11 </span>    55/push-ebp
-<span id="L12" class="LineNr">12 </span>    89/copy                         3/mod/direct    5/rm32/ebp   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          4/r32/esp  <span class="Normal"> . </span>             <span class="Normal"> . </span>                <span class="subxComment"># copy esp to ebp</span>
-<span id="L13" class="LineNr">13 </span>    <span class="subxS1Comment"># . save registers</span>
-<span id="L14" class="LineNr">14 </span>    51/push-ecx
-<span id="L15" class="LineNr">15 </span>    56/push-esi
-<span id="L16" class="LineNr">16 </span>    <span class="subxComment"># esi = s</span>
-<span id="L17" class="LineNr">17 </span>    8b/copy                         1/mod/*+disp8   5/rm32/ebp   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          6/r32/esi   8/disp8        <span class="Normal"> . </span>                <span class="subxComment"># copy *(ebp+8) to esi</span>
-<span id="L18" class="LineNr">18 </span>    <span class="subxComment"># ecx = s-&gt;read</span>
-<span id="L19" class="LineNr">19 </span>    8b/copy                         1/mod/*+disp8   6/rm32/esi   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          1/r32/ecx   4/disp8        <span class="Normal"> . </span>                <span class="subxComment"># copy *(esi+4) to ecx</span>
-<span id="L20" class="LineNr">20 </span>    <span class="subxComment"># if (f-&gt;read &gt;= f-&gt;write) abort</span>
-<span id="L21" class="LineNr">21 </span>    3b/compare                      0/mod/indirect  6/rm32/esi   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          1/r32/ecx  <span class="Normal"> . </span>             <span class="Normal"> . </span>                <span class="subxComment"># compare ecx with *esi</span>
-<span id="L22" class="LineNr">22 </span>    0f 8d/jump-if-&gt;=  $read-byte:end/disp32  <span class="subxComment"># TODO: abort</span>
-<span id="L23" class="LineNr">23 </span>    <span class="subxComment"># result = f-&gt;data[f-&gt;read]</span>
-<span id="L24" class="LineNr">24 </span>    31/xor                          3/mod/direct    0/rm32/eax   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          0/r32/eax  <span class="Normal"> . </span>             <span class="Normal"> . </span>                <span class="subxComment"># clear eax</span>
-<span id="L25" class="LineNr">25 </span>    8a/copy-byte                    1/mod/*+disp8   4/rm32/sib    6/base/esi  1/index/ecx  <span class="Normal"> . </span>          0/r32/AL    0xc/disp8      <span class="Normal"> . </span>                <span class="subxComment"># copy byte at *(esi+ecx+12) to AL</span>
-<span id="L26" class="LineNr">26 </span>    <span class="subxComment"># ++f-&gt;read</span>
-<span id="L27" class="LineNr">27 </span>    ff          0/subop/increment   1/mod/*+disp8   6/rm32/esi   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>         <span class="Normal"> . </span>          4/disp8        <span class="Normal"> . </span>                <span class="subxComment"># increment *(esi+4)</span>
-<span id="L28" class="LineNr">28 </span><span class="Constant">$read-byte:end</span>:
-<span id="L29" class="LineNr">29 </span>    <span class="subxS1Comment"># . restore registers</span>
-<span id="L30" class="LineNr">30 </span>    5e/pop-to-esi
-<span id="L31" class="LineNr">31 </span>    59/pop-to-ecx
-<span id="L32" class="LineNr">32 </span>    <span class="subxS1Comment"># . epilogue</span>
-<span id="L33" class="LineNr">33 </span>    89/copy                         3/mod/direct    4/rm32/esp   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          5/r32/ebp  <span class="Normal"> . </span>             <span class="Normal"> . </span>                <span class="subxComment"># copy ebp to esp</span>
-<span id="L34" class="LineNr">34 </span>    5d/pop-to-ebp
-<span id="L35" class="LineNr">35 </span>    c3/return
-<span id="L36" class="LineNr">36 </span>
-<span id="L37" class="LineNr">37 </span><span class="subxS2Comment"># . . vim&#0058;nowrap:textwidth=0</span>
+<span id="L1" class="LineNr"> 1 </span>== code
+<span id="L2" class="LineNr"> 2 </span><span class="subxComment">#   instruction                     effective address                                                   register    displacement    immediate</span>
+<span id="L3" class="LineNr"> 3 </span><span class="subxS1Comment"># . op          subop               mod             rm32          base        index         scale       r32</span>
+<span id="L4" class="LineNr"> 4 </span><span class="subxS1Comment"># . 1-3 bytes   3 bits              2 bits          3 bits        3 bits      3 bits        2 bits      2 bits      0/1/2/4 bytes   0/1/2/4 bytes</span>
+<span id="L5" class="LineNr"> 5 </span>
+<span id="L6" class="LineNr"> 6 </span><span class="subxComment"># TODO: read-byte-buffered</span>
+<span id="L7" class="LineNr"> 7 </span>
+<span id="L8" class="LineNr"> 8 </span><span class="subxComment"># Return next byte value in eax, with top 3 bytes cleared.</span>
+<span id="L9" class="LineNr"> 9 </span><span class="subxComment"># Abort on reaching end of stream.</span>
+<span id="L10" class="LineNr">10 </span><span class="subxFunction">read-byte</span>:  <span class="subxComment"># s: (addr stream byte) -&gt; result/eax: byte</span>
+<span id="L11" class="LineNr">11 </span>    <span class="subxS1Comment"># . prologue</span>
+<span id="L12" class="LineNr">12 </span>    55/push-ebp
+<span id="L13" class="LineNr">13 </span>    89/copy                         3/mod/direct    5/rm32/ebp   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          4/r32/esp  <span class="Normal"> . </span>             <span class="Normal"> . </span>                <span class="subxComment"># copy esp to ebp</span>
+<span id="L14" class="LineNr">14 </span>    <span class="subxS1Comment"># . save registers</span>
+<span id="L15" class="LineNr">15 </span>    51/push-ecx
+<span id="L16" class="LineNr">16 </span>    56/push-esi
+<span id="L17" class="LineNr">17 </span>    <span class="subxComment"># esi = s</span>
+<span id="L18" class="LineNr">18 </span>    8b/copy                         1/mod/*+disp8   5/rm32/ebp   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          6/r32/esi   8/disp8        <span class="Normal"> . </span>                <span class="subxComment"># copy *(ebp+8) to esi</span>
+<span id="L19" class="LineNr">19 </span>    <span class="subxComment"># ecx = s-&gt;read</span>
+<span id="L20" class="LineNr">20 </span>    8b/copy                         1/mod/*+disp8   6/rm32/esi   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          1/r32/ecx   4/disp8        <span class="Normal"> . </span>                <span class="subxComment"># copy *(esi+4) to ecx</span>
+<span id="L21" class="LineNr">21 </span>    <span class="subxComment"># if (f-&gt;read &gt;= f-&gt;write) abort</span>
+<span id="L22" class="LineNr">22 </span>    3b/compare                      0/mod/indirect  6/rm32/esi   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          1/r32/ecx  <span class="Normal"> . </span>             <span class="Normal"> . </span>                <span class="subxComment"># compare ecx with *esi</span>
+<span id="L23" class="LineNr">23 </span>    0f 8d/jump-if-&gt;=  $read-byte:end/disp32  <span class="subxComment"># TODO: abort</span>
+<span id="L24" class="LineNr">24 </span>    <span class="subxComment"># result = f-&gt;data[f-&gt;read]</span>
+<span id="L25" class="LineNr">25 </span>    31/xor                          3/mod/direct    0/rm32/eax   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          0/r32/eax  <span class="Normal"> . </span>             <span class="Normal"> . </span>                <span class="subxComment"># clear eax</span>
+<span id="L26" class="LineNr">26 </span>    8a/copy-byte                    1/mod/*+disp8   4/rm32/sib    6/base/esi  1/index/ecx  <span class="Normal"> . </span>          0/r32/AL    0xc/disp8      <span class="Normal"> . </span>                <span class="subxComment"># copy byte at *(esi+ecx+12) to AL</span>
+<span id="L27" class="LineNr">27 </span>    <span class="subxComment"># ++f-&gt;read</span>
+<span id="L28" class="LineNr">28 </span>    ff          0/subop/increment   1/mod/*+disp8   6/rm32/esi   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>         <span class="Normal"> . </span>          4/disp8        <span class="Normal"> . </span>                <span class="subxComment"># increment *(esi+4)</span>
+<span id="L29" class="LineNr">29 </span><span class="Constant">$read-byte:end</span>:
+<span id="L30" class="LineNr">30 </span>    <span class="subxS1Comment"># . restore registers</span>
+<span id="L31" class="LineNr">31 </span>    5e/pop-to-esi
+<span id="L32" class="LineNr">32 </span>    59/pop-to-ecx
+<span id="L33" class="LineNr">33 </span>    <span class="subxS1Comment"># . epilogue</span>
+<span id="L34" class="LineNr">34 </span>    89/copy                         3/mod/direct    4/rm32/esp   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          5/r32/ebp  <span class="Normal"> . </span>             <span class="Normal"> . </span>                <span class="subxComment"># copy ebp to esp</span>
+<span id="L35" class="LineNr">35 </span>    5d/pop-to-ebp
+<span id="L36" class="LineNr">36 </span>    c3/return
+<span id="L37" class="LineNr">37 </span>
+<span id="L38" class="LineNr">38 </span><span class="subxS2Comment"># . . vim&#0058;nowrap:textwidth=0</span>
 </pre>
 </body>
 </html>
diff --git a/html/baremetal/115write-byte.subx.html b/html/baremetal/115write-byte.subx.html
index 7bcd8a8a..1a23343f 100644
--- a/html/baremetal/115write-byte.subx.html
+++ b/html/baremetal/115write-byte.subx.html
@@ -56,43 +56,44 @@ if ('onhashchange' in window) {
 <body onload='JumpToLine();'>
 <a href='https://github.com/akkartik/mu/blob/main/baremetal/115write-byte.subx'>https://github.com/akkartik/mu/blob/main/baremetal/115write-byte.subx</a>
 <pre id='vimCodeElement'>
-<span id="L1" class="LineNr"> 1 </span><span class="subxComment">#   instruction                     effective address                                                   register    displacement    immediate</span>
-<span id="L2" class="LineNr"> 2 </span><span class="subxS1Comment"># . op          subop               mod             rm32          base        index         scale       r32</span>
-<span id="L3" class="LineNr"> 3 </span><span class="subxS1Comment"># . 1-3 bytes   3 bits              2 bits          3 bits        3 bits      3 bits        2 bits      2 bits      0/1/2/4 bytes   0/1/2/4 bytes</span>
-<span id="L4" class="LineNr"> 4 </span>
-<span id="L5" class="LineNr"> 5 </span><span class="subxComment"># Write lower byte of 'n' to 'f'.</span>
-<span id="L6" class="LineNr"> 6 </span><span class="subxFunction">append-byte</span>:  <span class="subxComment"># f: (addr stream byte), n: int</span>
-<span id="L7" class="LineNr"> 7 </span>    <span class="subxS1Comment"># . prologue</span>
-<span id="L8" class="LineNr"> 8 </span>    55/push-ebp
-<span id="L9" class="LineNr"> 9 </span>    89/copy                         3/mod/direct    5/rm32/ebp   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          4/r32/esp  <span class="Normal"> . </span>             <span class="Normal"> . </span>                <span class="subxComment"># copy esp to ebp</span>
-<span id="L10" class="LineNr">10 </span>    <span class="subxS1Comment"># . save registers</span>
-<span id="L11" class="LineNr">11 </span>    51/push-ecx
-<span id="L12" class="LineNr">12 </span>    57/push-edi
-<span id="L13" class="LineNr">13 </span>    <span class="subxComment"># edi = f</span>
-<span id="L14" class="LineNr">14 </span>    8b/copy                         1/mod/*+disp8   5/rm32/ebp   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          7/r32/edi   8/disp8        <span class="Normal"> . </span>                <span class="subxComment"># copy *(ebp+8) to edi</span>
-<span id="L15" class="LineNr">15 </span>    <span class="subxComment"># ecx = f-&gt;write</span>
-<span id="L16" class="LineNr">16 </span>    8b/copy                         0/mod/indirect  7/rm32/edi   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          1/r32/ecx  <span class="Normal"> . </span>             <span class="Normal"> . </span>                <span class="subxComment"># copy *edi to ecx</span>
-<span id="L17" class="LineNr">17 </span>    <span class="subxComment"># if (f-&gt;write &gt;= f-&gt;size) abort</span>
-<span id="L18" class="LineNr">18 </span>    3b/compare                      1/mod/*+disp8   7/rm32/edi   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          1/r32/ecx   8/disp8        <span class="Normal"> . </span>                <span class="subxComment"># compare ecx with *(edi+8)</span>
-<span id="L19" class="LineNr">19 </span>    7d/jump-if-&gt;=  $append-byte:end/disp8  <span class="subxComment"># TODO: abort</span>
-<span id="L20" class="LineNr">20 </span><span class="Constant">$append-byte:to-stream</span>:
-<span id="L21" class="LineNr">21 </span>    <span class="subxComment"># write to stream</span>
-<span id="L22" class="LineNr">22 </span>    <span class="subxComment"># f-&gt;data[f-&gt;write] = LSB(n)</span>
-<span id="L23" class="LineNr">23 </span>    31/xor                          3/mod/direct    0/rm32/eax   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          0/r32/eax  <span class="Normal"> . </span>             <span class="Normal"> . </span>                <span class="subxComment"># clear eax</span>
-<span id="L24" class="LineNr">24 </span>    8a/copy-byte                    1/mod/*+disp8   5/rm32/ebp   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          0/r32/AL    0xc/disp8      <span class="Normal"> . </span>                <span class="subxComment"># copy byte at *(ebp+12) to AL</span>
-<span id="L25" class="LineNr">25 </span>    88/copy-byte                    1/mod/*+disp8   4/rm32/sib    7/base/edi  1/index/ecx  <span class="Normal"> . </span>          0/r32/AL    0xc/disp8      <span class="Normal"> . </span>                <span class="subxComment"># copy AL to *(edi+ecx+12)</span>
-<span id="L26" class="LineNr">26 </span>    <span class="subxComment"># ++f-&gt;write</span>
-<span id="L27" class="LineNr">27 </span>    ff          0/subop/increment   0/mod/indirect  7/rm32/edi   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>         <span class="Normal"> . </span>         <span class="Normal"> . </span>             <span class="Normal"> . </span>                <span class="subxComment"># increment *edi</span>
-<span id="L28" class="LineNr">28 </span><span class="Constant">$append-byte:end</span>:
-<span id="L29" class="LineNr">29 </span>    <span class="subxS1Comment"># . restore registers</span>
-<span id="L30" class="LineNr">30 </span>    5f/pop-to-edi
-<span id="L31" class="LineNr">31 </span>    59/pop-to-ecx
-<span id="L32" class="LineNr">32 </span>    <span class="subxS1Comment"># . epilogue</span>
-<span id="L33" class="LineNr">33 </span>    89/copy                         3/mod/direct    4/rm32/esp   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          5/r32/ebp  <span class="Normal"> . </span>             <span class="Normal"> . </span>                <span class="subxComment"># copy ebp to esp</span>
-<span id="L34" class="LineNr">34 </span>    5d/pop-to-ebp
-<span id="L35" class="LineNr">35 </span>    c3/return
-<span id="L36" class="LineNr">36 </span>
-<span id="L37" class="LineNr">37 </span><span class="subxS2Comment"># . . vim&#0058;nowrap:textwidth=0</span>
+<span id="L1" class="LineNr"> 1 </span>== code
+<span id="L2" class="LineNr"> 2 </span><span class="subxComment">#   instruction                     effective address                                                   register    displacement    immediate</span>
+<span id="L3" class="LineNr"> 3 </span><span class="subxS1Comment"># . op          subop               mod             rm32          base        index         scale       r32</span>
+<span id="L4" class="LineNr"> 4 </span><span class="subxS1Comment"># . 1-3 bytes   3 bits              2 bits          3 bits        3 bits      3 bits        2 bits      2 bits      0/1/2/4 bytes   0/1/2/4 bytes</span>
+<span id="L5" class="LineNr"> 5 </span>
+<span id="L6" class="LineNr"> 6 </span><span class="subxComment"># Write lower byte of 'n' to 'f'.</span>
+<span id="L7" class="LineNr"> 7 </span><span class="subxFunction">append-byte</span>:  <span class="subxComment"># f: (addr stream byte), n: int</span>
+<span id="L8" class="LineNr"> 8 </span>    <span class="subxS1Comment"># . prologue</span>
+<span id="L9" class="LineNr"> 9 </span>    55/push-ebp
+<span id="L10" class="LineNr">10 </span>    89/copy                         3/mod/direct    5/rm32/ebp   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          4/r32/esp  <span class="Normal"> . </span>             <span class="Normal"> . </span>                <span class="subxComment"># copy esp to ebp</span>
+<span id="L11" class="LineNr">11 </span>    <span class="subxS1Comment"># . save registers</span>
+<span id="L12" class="LineNr">12 </span>    51/push-ecx
+<span id="L13" class="LineNr">13 </span>    57/push-edi
+<span id="L14" class="LineNr">14 </span>    <span class="subxComment"># edi = f</span>
+<span id="L15" class="LineNr">15 </span>    8b/copy                         1/mod/*+disp8   5/rm32/ebp   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          7/r32/edi   8/disp8        <span class="Normal"> . </span>                <span class="subxComment"># copy *(ebp+8) to edi</span>
+<span id="L16" class="LineNr">16 </span>    <span class="subxComment"># ecx = f-&gt;write</span>
+<span id="L17" class="LineNr">17 </span>    8b/copy                         0/mod/indirect  7/rm32/edi   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          1/r32/ecx  <span class="Normal"> . </span>             <span class="Normal"> . </span>                <span class="subxComment"># copy *edi to ecx</span>
+<span id="L18" class="LineNr">18 </span>    <span class="subxComment"># if (f-&gt;write &gt;= f-&gt;size) abort</span>
+<span id="L19" class="LineNr">19 </span>    3b/compare                      1/mod/*+disp8   7/rm32/edi   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          1/r32/ecx   8/disp8        <span class="Normal"> . </span>                <span class="subxComment"># compare ecx with *(edi+8)</span>
+<span id="L20" class="LineNr">20 </span>    7d/jump-if-&gt;=  $append-byte:end/disp8  <span class="subxComment"># TODO: abort</span>
+<span id="L21" class="LineNr">21 </span><span class="Constant">$append-byte:to-stream</span>:
+<span id="L22" class="LineNr">22 </span>    <span class="subxComment"># write to stream</span>
+<span id="L23" class="LineNr">23 </span>    <span class="subxComment"># f-&gt;data[f-&gt;write] = LSB(n)</span>
+<span id="L24" class="LineNr">24 </span>    31/xor                          3/mod/direct    0/rm32/eax   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          0/r32/eax  <span class="Normal"> . </span>             <span class="Normal"> . </span>                <span class="subxComment"># clear eax</span>
+<span id="L25" class="LineNr">25 </span>    8a/copy-byte                    1/mod/*+disp8   5/rm32/ebp   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          0/r32/AL    0xc/disp8      <span class="Normal"> . </span>                <span class="subxComment"># copy byte at *(ebp+12) to AL</span>
+<span id="L26" class="LineNr">26 </span>    88/copy-byte                    1/mod/*+disp8   4/rm32/sib    7/base/edi  1/index/ecx  <span class="Normal"> . </span>          0/r32/AL    0xc/disp8      <span class="Normal"> . </span>                <span class="subxComment"># copy AL to *(edi+ecx+12)</span>
+<span id="L27" class="LineNr">27 </span>    <span class="subxComment"># ++f-&gt;write</span>
+<span id="L28" class="LineNr">28 </span>    ff          0/subop/increment   0/mod/indirect  7/rm32/edi   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>         <span class="Normal"> . </span>         <span class="Normal"> . </span>             <span class="Normal"> . </span>                <span class="subxComment"># increment *edi</span>
+<span id="L29" class="LineNr">29 </span><span class="Constant">$append-byte:end</span>:
+<span id="L30" class="LineNr">30 </span>    <span class="subxS1Comment"># . restore registers</span>
+<span id="L31" class="LineNr">31 </span>    5f/pop-to-edi
+<span id="L32" class="LineNr">32 </span>    59/pop-to-ecx
+<span id="L33" class="LineNr">33 </span>    <span class="subxS1Comment"># . epilogue</span>
+<span id="L34" class="LineNr">34 </span>    89/copy                         3/mod/direct    4/rm32/esp   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          5/r32/ebp  <span class="Normal"> . </span>             <span class="Normal"> . </span>                <span class="subxComment"># copy ebp to esp</span>
+<span id="L35" class="LineNr">35 </span>    5d/pop-to-ebp
+<span id="L36" class="LineNr">36 </span>    c3/return
+<span id="L37" class="LineNr">37 </span>
+<span id="L38" class="LineNr">38 </span><span class="subxS2Comment"># . . vim&#0058;nowrap:textwidth=0</span>
 </pre>
 </body>
 </html>
diff --git a/html/baremetal/120allocate.subx.html b/html/baremetal/120allocate.subx.html
index 11c874ee..d3bc3fc8 100644
--- a/html/baremetal/120allocate.subx.html
+++ b/html/baremetal/120allocate.subx.html
@@ -56,58 +56,59 @@ if ('onhashchange' in window) {
 <body onload='JumpToLine();'>
 <a href='https://github.com/akkartik/mu/blob/main/baremetal/120allocate.subx'>https://github.com/akkartik/mu/blob/main/baremetal/120allocate.subx</a>
 <pre id='vimCodeElement'>
-<span id="L1" class="LineNr"> 1 </span><span class="subxComment">#   instruction                     effective address                                                   register    displacement    immediate</span>
-<span id="L2" class="LineNr"> 2 </span><span class="subxS1Comment"># . op          subop               mod             rm32          base        index         scale       r32</span>
-<span id="L3" class="LineNr"> 3 </span><span class="subxS1Comment"># . 1-3 bytes   3 bits              2 bits          3 bits        3 bits      3 bits        2 bits      2 bits      0/1/2/4 bytes   0/1/2/4 bytes</span>
-<span id="L4" class="LineNr"> 4 </span>
-<span id="L5" class="LineNr"> 5 </span><span class="subxComment"># Fill a region of memory with zeroes.</span>
-<span id="L6" class="LineNr"> 6 </span><span class="subxFunction">zero-out</span>:  <span class="subxComment"># start: (addr byte), size: int</span>
-<span id="L7" class="LineNr"> 7 </span>    <span class="subxComment"># pseudocode:</span>
-<span id="L8" class="LineNr"> 8 </span>    <span class="subxComment">#   curr/esi = start</span>
-<span id="L9" class="LineNr"> 9 </span>    <span class="subxComment">#   i/ecx = 0</span>
-<span id="L10" class="LineNr">10 </span>    <span class="subxComment">#   while true</span>
-<span id="L11" class="LineNr">11 </span>    <span class="subxComment">#     if (i &gt;= size) break</span>
-<span id="L12" class="LineNr">12 </span>    <span class="subxComment">#     *curr = 0</span>
-<span id="L13" class="LineNr">13 </span>    <span class="subxComment">#     ++curr</span>
-<span id="L14" class="LineNr">14 </span>    <span class="subxComment">#     ++i</span>
-<span id="L15" class="LineNr">15 </span>    <span class="subxComment">#</span>
-<span id="L16" class="LineNr">16 </span>    <span class="subxS1Comment"># . prologue</span>
-<span id="L17" class="LineNr">17 </span>    55/push-ebp
-<span id="L18" class="LineNr">18 </span>    89/copy                         3/mod/direct    5/rm32/ebp   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          4/r32/esp  <span class="Normal"> . </span>             <span class="Normal"> . </span>                <span class="subxComment"># copy esp to ebp</span>
-<span id="L19" class="LineNr">19 </span>    <span class="subxS1Comment"># . save registers</span>
-<span id="L20" class="LineNr">20 </span>    50/push-eax
-<span id="L21" class="LineNr">21 </span>    51/push-ecx
-<span id="L22" class="LineNr">22 </span>    52/push-edx
-<span id="L23" class="LineNr">23 </span>    56/push-esi
-<span id="L24" class="LineNr">24 </span>    <span class="subxComment"># curr/esi = start</span>
-<span id="L25" class="LineNr">25 </span>    8b/copy                         1/mod/*+disp8   5/rm32/ebp   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          6/r32/esi   8/disp8        <span class="Normal"> . </span>                <span class="subxComment"># copy *(ebp+8) to esi</span>
-<span id="L26" class="LineNr">26 </span>    <span class="subxComment"># var i/ecx: int = 0</span>
-<span id="L27" class="LineNr">27 </span>    31/xor                          3/mod/direct    1/rm32/ecx   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          1/r32/ecx  <span class="Normal"> . </span>             <span class="Normal"> . </span>                <span class="subxComment"># clear ecx</span>
-<span id="L28" class="LineNr">28 </span>    <span class="subxComment"># edx = size</span>
-<span id="L29" class="LineNr">29 </span>    8b/copy                         1/mod/*+disp8   5/rm32/ebp   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          2/r32/edx   0xc/disp8      <span class="Normal"> . </span>                <span class="subxComment"># copy *(ebp+12) to edx</span>
-<span id="L30" class="LineNr">30 </span><span class="Constant">$zero-out:loop</span>:
-<span id="L31" class="LineNr">31 </span>    <span class="subxComment"># if (i &gt;= size) break</span>
-<span id="L32" class="LineNr">32 </span>    39/compare                      3/mod/direct    1/rm32/ecx   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          2/r32/edx  <span class="Normal"> . </span>             <span class="Normal"> . </span>                <span class="subxComment"># compare ecx with edx</span>
-<span id="L33" class="LineNr">33 </span>    7d/jump-if-&gt;=  $zero-out:end/disp8
-<span id="L34" class="LineNr">34 </span>    <span class="subxComment"># *curr = 0</span>
-<span id="L35" class="LineNr">35 </span>    c6          0/subop/copy-byte   0/mod/direct    6/rm32/esi   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>         <span class="Normal"> . </span>         <span class="Normal"> . </span>              0/imm8            <span class="subxComment"># copy byte to *esi</span>
-<span id="L36" class="LineNr">36 </span>    <span class="subxComment"># ++curr</span>
-<span id="L37" class="LineNr">37 </span>    46/increment-esi
-<span id="L38" class="LineNr">38 </span>    <span class="subxComment"># ++i</span>
-<span id="L39" class="LineNr">39 </span>    41/increment-ecx
-<span id="L40" class="LineNr">40 </span>    eb/jump  $zero-out:<span class="Constant">loop</span>/disp8
-<span id="L41" class="LineNr">41 </span><span class="Constant">$zero-out:end</span>:
-<span id="L42" class="LineNr">42 </span>    <span class="subxS1Comment"># . restore registers</span>
-<span id="L43" class="LineNr">43 </span>    5e/pop-to-esi
-<span id="L44" class="LineNr">44 </span>    5a/pop-to-edx
-<span id="L45" class="LineNr">45 </span>    59/pop-to-ecx
-<span id="L46" class="LineNr">46 </span>    58/pop-to-eax
-<span id="L47" class="LineNr">47 </span>    <span class="subxS1Comment"># . epilogue</span>
-<span id="L48" class="LineNr">48 </span>    89/copy                         3/mod/direct    4/rm32/esp   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          5/r32/ebp  <span class="Normal"> . </span>             <span class="Normal"> . </span>                <span class="subxComment"># copy ebp to esp</span>
-<span id="L49" class="LineNr">49 </span>    5d/pop-to-ebp
-<span id="L50" class="LineNr">50 </span>    c3/return
-<span id="L51" class="LineNr">51 </span>
-<span id="L52" class="LineNr">52 </span><span class="subxS2Comment"># . . vim&#0058;nowrap:textwidth=0</span>
+<span id="L1" class="LineNr"> 1 </span>== code
+<span id="L2" class="LineNr"> 2 </span><span class="subxComment">#   instruction                     effective address                                                   register    displacement    immediate</span>
+<span id="L3" class="LineNr"> 3 </span><span class="subxS1Comment"># . op          subop               mod             rm32          base        index         scale       r32</span>
+<span id="L4" class="LineNr"> 4 </span><span class="subxS1Comment"># . 1-3 bytes   3 bits              2 bits          3 bits        3 bits      3 bits        2 bits      2 bits      0/1/2/4 bytes   0/1/2/4 bytes</span>
+<span id="L5" class="LineNr"> 5 </span>
+<span id="L6" class="LineNr"> 6 </span><span class="subxComment"># Fill a region of memory with zeroes.</span>
+<span id="L7" class="LineNr"> 7 </span><span class="subxFunction">zero-out</span>:  <span class="subxComment"># start: (addr byte), size: int</span>
+<span id="L8" class="LineNr"> 8 </span>    <span class="subxComment"># pseudocode:</span>
+<span id="L9" class="LineNr"> 9 </span>    <span class="subxComment">#   curr/esi = start</span>
+<span id="L10" class="LineNr">10 </span>    <span class="subxComment">#   i/ecx = 0</span>
+<span id="L11" class="LineNr">11 </span>    <span class="subxComment">#   while true</span>
+<span id="L12" class="LineNr">12 </span>    <span class="subxComment">#     if (i &gt;= size) break</span>
+<span id="L13" class="LineNr">13 </span>    <span class="subxComment">#     *curr = 0</span>
+<span id="L14" class="LineNr">14 </span>    <span class="subxComment">#     ++curr</span>
+<span id="L15" class="LineNr">15 </span>    <span class="subxComment">#     ++i</span>
+<span id="L16" class="LineNr">16 </span>    <span class="subxComment">#</span>
+<span id="L17" class="LineNr">17 </span>    <span class="subxS1Comment"># . prologue</span>
+<span id="L18" class="LineNr">18 </span>    55/push-ebp
+<span id="L19" class="LineNr">19 </span>    89/copy                         3/mod/direct    5/rm32/ebp   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          4/r32/esp  <span class="Normal"> . </span>             <span class="Normal"> . </span>                <span class="subxComment"># copy esp to ebp</span>
+<span id="L20" class="LineNr">20 </span>    <span class="subxS1Comment"># . save registers</span>
+<span id="L21" class="LineNr">21 </span>    50/push-eax
+<span id="L22" class="LineNr">22 </span>    51/push-ecx
+<span id="L23" class="LineNr">23 </span>    52/push-edx
+<span id="L24" class="LineNr">24 </span>    56/push-esi
+<span id="L25" class="LineNr">25 </span>    <span class="subxComment"># curr/esi = start</span>
+<span id="L26" class="LineNr">26 </span>    8b/copy                         1/mod/*+disp8   5/rm32/ebp   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          6/r32/esi   8/disp8        <span class="Normal"> . </span>                <span class="subxComment"># copy *(ebp+8) to esi</span>
+<span id="L27" class="LineNr">27 </span>    <span class="subxComment"># var i/ecx: int = 0</span>
+<span id="L28" class="LineNr">28 </span>    31/xor                          3/mod/direct    1/rm32/ecx   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          1/r32/ecx  <span class="Normal"> . </span>             <span class="Normal"> . </span>                <span class="subxComment"># clear ecx</span>
+<span id="L29" class="LineNr">29 </span>    <span class="subxComment"># edx = size</span>
+<span id="L30" class="LineNr">30 </span>    8b/copy                         1/mod/*+disp8   5/rm32/ebp   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          2/r32/edx   0xc/disp8      <span class="Normal"> . </span>                <span class="subxComment"># copy *(ebp+12) to edx</span>
+<span id="L31" class="LineNr">31 </span><span class="Constant">$zero-out:loop</span>:
+<span id="L32" class="LineNr">32 </span>    <span class="subxComment"># if (i &gt;= size) break</span>
+<span id="L33" class="LineNr">33 </span>    39/compare                      3/mod/direct    1/rm32/ecx   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          2/r32/edx  <span class="Normal"> . </span>             <span class="Normal"> . </span>                <span class="subxComment"># compare ecx with edx</span>
+<span id="L34" class="LineNr">34 </span>    7d/jump-if-&gt;=  $zero-out:end/disp8
+<span id="L35" class="LineNr">35 </span>    <span class="subxComment"># *curr = 0</span>
+<span id="L36" class="LineNr">36 </span>    c6          0/subop/copy-byte   0/mod/direct    6/rm32/esi   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>         <span class="Normal"> . </span>         <span class="Normal"> . </span>              0/imm8            <span class="subxComment"># copy byte to *esi</span>
+<span id="L37" class="LineNr">37 </span>    <span class="subxComment"># ++curr</span>
+<span id="L38" class="LineNr">38 </span>    46/increment-esi
+<span id="L39" class="LineNr">39 </span>    <span class="subxComment"># ++i</span>
+<span id="L40" class="LineNr">40 </span>    41/increment-ecx
+<span id="L41" class="LineNr">41 </span>    eb/jump  $zero-out:<span class="Constant">loop</span>/disp8
+<span id="L42" class="LineNr">42 </span><span class="Constant">$zero-out:end</span>:
+<span id="L43" class="LineNr">43 </span>    <span class="subxS1Comment"># . restore registers</span>
+<span id="L44" class="LineNr">44 </span>    5e/pop-to-esi
+<span id="L45" class="LineNr">45 </span>    5a/pop-to-edx
+<span id="L46" class="LineNr">46 </span>    59/pop-to-ecx
+<span id="L47" class="LineNr">47 </span>    58/pop-to-eax
+<span id="L48" class="LineNr">48 </span>    <span class="subxS1Comment"># . epilogue</span>
+<span id="L49" class="LineNr">49 </span>    89/copy                         3/mod/direct    4/rm32/esp   <span class="Normal"> . </span>         <span class="Normal"> . </span>           <span class="Normal"> . </span>          5/r32/ebp  <span class="Normal"> . </span>             <span class="Normal"> . </span>                <span class="subxComment"># copy ebp to esp</span>
+<span id="L50" class="LineNr">50 </span>    5d/pop-to-ebp
+<span id="L51" class="LineNr">51 </span>    c3/return
+<span id="L52" class="LineNr">52 </span>
+<span id="L53" class="LineNr">53 </span><span class="subxS2Comment"># . . vim&#0058;nowrap:textwidth=0</span>
 </pre>
 </body>
 </html>
diff --git a/html/baremetal/302stack_allocate.subx.html b/html/baremetal/302stack_allocate.subx.html
index 0cbbf443..af165122 100644
--- a/html/baremetal/302stack_allocate.subx.html
+++ b/html/baremetal/302stack_allocate.subx.html
@@ -104,7 +104,7 @@ if ('onhashchange' in window) {
 <span id="L47" class="LineNr">47 </span>    89/&lt;- *<span class="SpecialChar"><a href='302stack_allocate.subx.html#L58'>Push-n-zero-bytes-esp</a></span> 4/r32/esp
 <span id="L48" class="LineNr">48 </span>    81 0/subop/add *<span class="SpecialChar"><a href='302stack_allocate.subx.html#L58'>Push-n-zero-bytes-esp</a></span> 4/imm32
 <span id="L49" class="LineNr">49 </span>    81 0/subop/add *(ebp+4) 4/imm32
-<span id="L50" class="LineNr">50 </span>    (<a href='120allocate.subx.html#L6'>zero-out</a> *<span class="SpecialChar"><a href='302stack_allocate.subx.html#L58'>Push-n-zero-bytes-esp</a></span> *(ebp+4))  <span class="subxComment"># n+4</span>
+<span id="L50" class="LineNr">50 </span>    (<a href='120allocate.subx.html#L7'>zero-out</a> *<span class="SpecialChar"><a href='302stack_allocate.subx.html#L58'>Push-n-zero-bytes-esp</a></span> *(ebp+4))  <span class="subxComment"># n+4</span>
 <span id="L51" class="LineNr">51 </span><span class="Constant">$push-n-zero-bytes:epilogue</span>:
 <span id="L52" class="LineNr">52 </span>    8b/-&gt; *<span class="SpecialChar"><a href='302stack_allocate.subx.html#L56'>Push-n-zero-bytes-ebp</a></span> 5/r32/ebp  <span class="subxComment"># restore spill</span>
 <span id="L53" class="LineNr">53 </span>    c3/return
diff --git a/html/baremetal/309stream.subx.html b/html/baremetal/309stream.subx.html
index 16e45ed7..3883daba 100644
--- a/html/baremetal/309stream.subx.html
+++ b/html/baremetal/309stream.subx.html
@@ -137,7 +137,7 @@ if ('onhashchange' in window) {
 <span id="L81" class="LineNr"> 81 </span>    8b/-&gt; *(ebp+0x10) 1/r32/ecx
 <span id="L82" class="LineNr"> 82 </span>    8d/copy-address *(eax+ecx) 1/r32/ecx
 <span id="L83" class="LineNr"> 83 </span>    <span class="subxComment">#</span>
-<span id="L84" class="LineNr"> 84 </span>    (<a href='108write.subx.html#L86'>_append-4</a>  %edx %ebx  %eax %ecx)  <span class="subxComment"># =&gt; eax</span>
+<span id="L84" class="LineNr"> 84 </span>    (<a href='108write.subx.html#L87'>_append-4</a>  %edx %ebx  %eax %ecx)  <span class="subxComment"># =&gt; eax</span>
 <span id="L85" class="LineNr"> 85 </span>    <span class="subxComment"># s-&gt;write += n</span>
 <span id="L86" class="LineNr"> 86 </span>    8b/-&gt; *(ebp+0x10) 1/r32/ecx
 <span id="L87" class="LineNr"> 87 </span>    01/add-to *edi 1/r32/ecx
@@ -183,7 +183,7 @@ if ('onhashchange' in window) {
 <span id="L127" class="LineNr">127 </span>    8b/-&gt; *(ebp+0x10) 1/r32/ecx
 <span id="L128" class="LineNr">128 </span>    8d/copy-address *(eax+ecx) 1/r32/ecx
 <span id="L129" class="LineNr">129 </span>    <span class="subxComment">#</span>
-<span id="L130" class="LineNr">130 </span>    (<a href='108write.subx.html#L86'>_append-4</a>  %eax %ecx  %edx %ebx)  <span class="subxComment"># =&gt; eax</span>
+<span id="L130" class="LineNr">130 </span>    (<a href='108write.subx.html#L87'>_append-4</a>  %eax %ecx  %edx %ebx)  <span class="subxComment"># =&gt; eax</span>
 <span id="L131" class="LineNr">131 </span>    <span class="subxComment"># s-&gt;read += n</span>
 <span id="L132" class="LineNr">132 </span>    8b/-&gt; *(ebp+0x10) 1/r32/ecx
 <span id="L133" class="LineNr">133 </span>    01/add-to *(esi+4) 1/r32/ecx
diff --git a/html/baremetal/313index-bounds-check.subx.html b/html/baremetal/313index-bounds-check.subx.html
index a6421293..2dc4cfc4 100644
--- a/html/baremetal/313index-bounds-check.subx.html
+++ b/html/baremetal/313index-bounds-check.subx.html
@@ -56,15 +56,17 @@ if ('onhashchange' in window) {
 <pre id='vimCodeElement'>
 <span id="L1" class="LineNr"> 1 </span><span class="subxComment"># TODO: bring this back</span>
 <span id="L2" class="LineNr"> 2 </span>
-<span id="L3" class="LineNr"> 3 </span><span class="subxMinorFunction">__check-mu-array-bounds</span>:  <span class="subxComment"># index: int, elem-size: int, arr-size: int, function-name: (addr array byte), array-name: (addr array byte)</span>
-<span id="L4" class="LineNr"> 4 </span>    <span class="subxS1Comment"># . prologue</span>
-<span id="L5" class="LineNr"> 5 </span>    55/push-ebp
-<span id="L6" class="LineNr"> 6 </span>    89/&lt;- %ebp 4/r32/esp
-<span id="L7" class="LineNr"> 7 </span><span class="Constant">$__check-mu-array-bounds:end</span>:
-<span id="L8" class="LineNr"> 8 </span>    <span class="subxS1Comment"># . epilogue</span>
-<span id="L9" class="LineNr"> 9 </span>    89/&lt;- %esp 5/r32/ebp
-<span id="L10" class="LineNr">10 </span>    5d/pop-to-ebp
-<span id="L11" class="LineNr">11 </span>    c3/return
+<span id="L3" class="LineNr"> 3 </span>== code
+<span id="L4" class="LineNr"> 4 </span>
+<span id="L5" class="LineNr"> 5 </span><span class="subxMinorFunction">__check-mu-array-bounds</span>:  <span class="subxComment"># index: int, elem-size: int, arr-size: int, function-name: (addr array byte), array-name: (addr array byte)</span>
+<span id="L6" class="LineNr"> 6 </span>    <span class="subxS1Comment"># . prologue</span>
+<span id="L7" class="LineNr"> 7 </span>    55/push-ebp
+<span id="L8" class="LineNr"> 8 </span>    89/&lt;- %ebp 4/r32/esp
+<span id="L9" class="LineNr"> 9 </span><span class="Constant">$__check-mu-array-bounds:end</span>:
+<span id="L10" class="LineNr">10 </span>    <span class="subxS1Comment"># . epilogue</span>
+<span id="L11" class="LineNr">11 </span>    89/&lt;- %esp 5/r32/ebp
+<span id="L12" class="LineNr">12 </span>    5d/pop-to-ebp
+<span id="L13" class="LineNr">13 </span>    c3/return
 </pre>
 </body>
 </html>
diff --git a/html/baremetal/400.mu.html b/html/baremetal/400.mu.html
index 95835ad8..67aed2ec 100644
--- a/html/baremetal/400.mu.html
+++ b/html/baremetal/400.mu.html
@@ -17,6 +17,7 @@ a { color:inherit; }
 .PreProc { color: #c000c0; }
 .LineNr { }
 .Constant { color: #008787; }
+.muComment { color: #005faf; }
 -->
 </style>
 
@@ -52,17 +53,26 @@ if ('onhashchange' in window) {
 <body onload='JumpToLine();'>
 <a href='https://github.com/akkartik/mu/blob/main/baremetal/400.mu'>https://github.com/akkartik/mu/blob/main/baremetal/400.mu</a>
 <pre id='vimCodeElement'>
-<span id="L1" class="LineNr"> 1 </span><span class="PreProc">sig</span> <a href='101screen.subx.html#L3'>pixel</a> screen: (addr screen), x: int, y: int, color: int
-<span id="L2" class="LineNr"> 2 </span><span class="PreProc">sig</span> <a href='102keyboard.subx.html#L3'>read-key</a> kbd: (addr keyboard)<span class="PreProc"> -&gt; </span>_/<span class="Constant">eax</span>: byte
-<span id="L3" class="LineNr"> 3 </span><span class="PreProc">sig</span> <a href='103grapheme.subx.html#L1'>draw-grapheme</a> screen: (addr screen), g: grapheme, x: int, y: int, color: int
-<span id="L4" class="LineNr"> 4 </span><span class="PreProc">sig</span> <a href='103grapheme.subx.html#L73'>cursor-position</a> screen: (addr screen)<span class="PreProc"> -&gt; </span>_/<span class="Constant">eax</span>: int, _/<span class="Constant">ecx</span>: int
-<span id="L5" class="LineNr"> 5 </span><span class="PreProc">sig</span> <a href='103grapheme.subx.html#L86'>set-cursor-position</a> screen: (addr screen), x: int, y: int
-<span id="L6" class="LineNr"> 6 </span><span class="PreProc">sig</span> <a href='106stream.subx.html#L17'>clear-stream</a> f: (addr stream _)
-<span id="L7" class="LineNr"> 7 </span><span class="PreProc">sig</span> <a href='106stream.subx.html#L56'>rewind-stream</a> f: (addr stream _)
-<span id="L8" class="LineNr"> 8 </span><span class="PreProc">sig</span> <a href='108write.subx.html#L5'>write</a> f: (addr stream byte), s: (addr array byte)
-<span id="L9" class="LineNr"> 9 </span><span class="PreProc">sig</span> <a href='115write-byte.subx.html#L6'>append-byte</a> f: (addr stream byte), n: int
-<span id="L10" class="LineNr">10 </span><span class="PreProc">sig</span> <a href='112read-byte.subx.html#L9'>read-byte</a> s: (addr stream byte)<span class="PreProc"> -&gt; </span>_/<span class="Constant">eax</span>: byte
-<span id="L11" class="LineNr">11 </span><span class="PreProc">sig</span> <a href='309stream.subx.html#L6'>stream-empty?</a> s: (addr stream _)<span class="PreProc"> -&gt; </span>_/<span class="Constant">eax</span>: boolean
+<span id="L1" class="LineNr"> 1 </span><span class="muComment"># screen</span>
+<span id="L2" class="LineNr"> 2 </span><span class="PreProc">sig</span> <a href='101screen.subx.html#L5'>pixel</a> screen: (addr screen), x: int, y: int, color: int
+<span id="L3" class="LineNr"> 3 </span><span class="PreProc">sig</span> <a href='103grapheme.subx.html#L5'>draw-grapheme</a> screen: (addr screen), g: grapheme, x: int, y: int, color: int
+<span id="L4" class="LineNr"> 4 </span><span class="PreProc">sig</span> <a href='103grapheme.subx.html#L77'>cursor-position</a> screen: (addr screen)<span class="PreProc"> -&gt; </span>_/<span class="Constant">eax</span>: int, _/<span class="Constant">ecx</span>: int
+<span id="L5" class="LineNr"> 5 </span><span class="PreProc">sig</span> <a href='103grapheme.subx.html#L90'>set-cursor-position</a> screen: (addr screen), x: int, y: int
+<span id="L6" class="LineNr"> 6 </span>
+<span id="L7" class="LineNr"> 7 </span><span class="muComment"># keyboard</span>
+<span id="L8" class="LineNr"> 8 </span><span class="PreProc">sig</span> <a href='102keyboard.subx.html#L6'>read-key</a> kbd: (addr keyboard)<span class="PreProc"> -&gt; </span>_/<span class="Constant">eax</span>: byte
+<span id="L9" class="LineNr"> 9 </span>
+<span id="L10" class="LineNr">10 </span><span class="muComment"># tests</span>
+<span id="L11" class="LineNr">11 </span><span class="PreProc">sig</span> <a href='104test.subx.html#L5'>count-test-failure</a>
+<span id="L12" class="LineNr">12 </span><span class="PreProc">sig</span> <a href='104test.subx.html#L17'>num-test-failures</a><span class="PreProc"> -&gt; </span>_/<span class="Constant">eax</span>: int
+<span id="L13" class="LineNr">13 </span>
+<span id="L14" class="LineNr">14 </span><span class="muComment"># streams</span>
+<span id="L15" class="LineNr">15 </span><span class="PreProc">sig</span> <a href='106stream.subx.html#L17'>clear-stream</a> f: (addr stream _)
+<span id="L16" class="LineNr">16 </span><span class="PreProc">sig</span> <a href='106stream.subx.html#L56'>rewind-stream</a> f: (addr stream _)
+<span id="L17" class="LineNr">17 </span><span class="PreProc">sig</span> <a href='108write.subx.html#L6'>write</a> f: (addr stream byte), s: (addr array byte)
+<span id="L18" class="LineNr">18 </span><span class="PreProc">sig</span> <a href='115write-byte.subx.html#L7'>append-byte</a> f: (addr stream byte), n: int
+<span id="L19" class="LineNr">19 </span><span class="PreProc">sig</span> <a href='112read-byte.subx.html#L10'>read-byte</a> s: (addr stream byte)<span class="PreProc"> -&gt; </span>_/<span class="Constant">eax</span>: byte
+<span id="L20" class="LineNr">20 </span><span class="PreProc">sig</span> <a href='309stream.subx.html#L6'>stream-empty?</a> s: (addr stream _)<span class="PreProc"> -&gt; </span>_/<span class="Constant">eax</span>: boolean
 </pre>
 </body>
 </html>
diff --git a/html/baremetal/403unicode.mu.html b/html/baremetal/403unicode.mu.html
index b1118a7c..1b70148c 100644
--- a/html/baremetal/403unicode.mu.html
+++ b/html/baremetal/403unicode.mu.html
@@ -155,7 +155,7 @@ if ('onhashchange' in window) {
 <span id="L97" class="LineNr"> 97 </span>    <span class="PreProc">break-if-=</span>
 <span id="L98" class="LineNr"> 98 </span>    <span class="PreProc">return</span> <span class="Constant">0xffffffff</span>
 <span id="L99" class="LineNr"> 99 </span>  <span class="Delimiter">}</span>
-<span id="L100" class="LineNr">100 </span>  <span class="PreProc">var</span> c/<span class="Constant">eax</span>: byte <span class="SpecialChar">&lt;-</span> <a href='112read-byte.subx.html#L9'>read-byte</a> in
+<span id="L100" class="LineNr">100 </span>  <span class="PreProc">var</span> c/<span class="Constant">eax</span>: byte <span class="SpecialChar">&lt;-</span> <a href='112read-byte.subx.html#L10'>read-byte</a> in
 <span id="L101" class="LineNr">101 </span>  <span class="PreProc">var</span> num-trailers/<span class="Constant">ecx</span>: int <span class="SpecialChar">&lt;-</span> copy <span class="Constant">0</span>
 <span id="L102" class="LineNr">102 </span>  $read-grapheme:compute-length: <span class="Delimiter">{</span>
 <span id="L103" class="LineNr">103 </span>    <span class="muComment"># single byte: just return it</span>
@@ -201,7 +201,7 @@ if ('onhashchange' in window) {
 <span id="L143" class="LineNr">143 </span>  <span class="Delimiter">{</span>
 <span id="L144" class="LineNr">144 </span>    compare num-trailers, <span class="Constant">0</span>
 <span id="L145" class="LineNr">145 </span>    <span class="PreProc">break-if-&lt;=</span>
-<span id="L146" class="LineNr">146 </span>    <span class="PreProc">var</span> tmp/<span class="Constant">eax</span>: byte <span class="SpecialChar">&lt;-</span> <a href='112read-byte.subx.html#L9'>read-byte</a> in
+<span id="L146" class="LineNr">146 </span>    <span class="PreProc">var</span> tmp/<span class="Constant">eax</span>: byte <span class="SpecialChar">&lt;-</span> <a href='112read-byte.subx.html#L10'>read-byte</a> in
 <span id="L147" class="LineNr">147 </span>    <span class="PreProc">var</span> tmp2/<span class="Constant">eax</span>: int <span class="SpecialChar">&lt;-</span> copy tmp
 <span id="L148" class="LineNr">148 </span>    tmp2 <span class="SpecialChar">&lt;-</span> <a href='403unicode.mu.html#L159'>shift-left-bytes</a> tmp2, num-byte-shifts
 <span id="L149" class="LineNr">149 </span>    result <span class="SpecialChar">&lt;-</span> or tmp2
@@ -234,19 +234,19 @@ if ('onhashchange' in window) {
 <span id="L176" class="LineNr">176 </span><span class="PreProc">fn</span> <span class="muFunction"><a href='403unicode.mu.html#L176'>write-grapheme</a></span> out: (addr stream byte), g: grapheme <span class="Delimiter">{</span>
 <span id="L177" class="LineNr">177 </span>$write-grapheme:body: <span class="Delimiter">{</span>
 <span id="L178" class="LineNr">178 </span>  <span class="PreProc">var</span> c/<span class="Constant">eax</span>: int <span class="SpecialChar">&lt;-</span> copy g
-<span id="L179" class="LineNr">179 </span>  <a href='115write-byte.subx.html#L6'>append-byte</a> out, c  <span class="muComment"># first byte is always written</span>
+<span id="L179" class="LineNr">179 </span>  <a href='115write-byte.subx.html#L7'>append-byte</a> out, c  <span class="muComment"># first byte is always written</span>
 <span id="L180" class="LineNr">180 </span>  c <span class="SpecialChar">&lt;-</span> shift-right <span class="Constant">8</span>
 <span id="L181" class="LineNr">181 </span>  compare c, <span class="Constant">0</span>
 <span id="L182" class="LineNr">182 </span>  <span class="PreProc">break-if-=</span> $write-grapheme:body
-<span id="L183" class="LineNr">183 </span>  <a href='115write-byte.subx.html#L6'>append-byte</a> out, c
+<span id="L183" class="LineNr">183 </span>  <a href='115write-byte.subx.html#L7'>append-byte</a> out, c
 <span id="L184" class="LineNr">184 </span>  c <span class="SpecialChar">&lt;-</span> shift-right <span class="Constant">8</span>
 <span id="L185" class="LineNr">185 </span>  compare c, <span class="Constant">0</span>
 <span id="L186" class="LineNr">186 </span>  <span class="PreProc">break-if-=</span> $write-grapheme:body
-<span id="L187" class="LineNr">187 </span>  <a href='115write-byte.subx.html#L6'>append-byte</a> out, c
+<span id="L187" class="LineNr">187 </span>  <a href='115write-byte.subx.html#L7'>append-byte</a> out, c
 <span id="L188" class="LineNr">188 </span>  c <span class="SpecialChar">&lt;-</span> shift-right <span class="Constant">8</span>
 <span id="L189" class="LineNr">189 </span>  compare c, <span class="Constant">0</span>
 <span id="L190" class="LineNr">190 </span>  <span class="PreProc">break-if-=</span> $write-grapheme:body
-<span id="L191" class="LineNr">191 </span>  <a href='115write-byte.subx.html#L6'>append-byte</a> out, c
+<span id="L191" class="LineNr">191 </span>  <a href='115write-byte.subx.html#L7'>append-byte</a> out, c
 <span id="L192" class="LineNr">192 </span><span class="Delimiter">}</span>
 <span id="L193" class="LineNr">193 </span><span class="Delimiter">}</span>
 </pre>
diff --git a/html/baremetal/500clear-screen.mu.html b/html/baremetal/500clear-screen.mu.html
new file mode 100644
index 00000000..e78089e6
--- /dev/null
+++ b/html/baremetal/500clear-screen.mu.html
@@ -0,0 +1,79 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
+<html>
+<head>
+<meta http-equiv="content-type" content="text/html; charset=UTF-8">
+<title>Mu - baremetal/500clear-screen.mu</title>
+<meta name="Generator" content="Vim/8.1">
+<meta name="plugin-version" content="vim8.1_v1">
+<meta name="syntax" content="none">
+<meta name="settings" content="number_lines,use_css,pre_wrap,no_foldcolumn,expand_tabs,line_ids,prevent_copy=">
+<meta name="colorscheme" content="minimal-light">
+<style type="text/css">
+<!--
+pre { white-space: pre-wrap; font-family: monospace; color: #000000; background-color: #c6c6c6; }
+body { font-size:12pt; font-family: monospace; color: #000000; background-color: #c6c6c6; }
+a { color:inherit; }
+* { font-size:12pt; font-size: 1em; }
+.PreProc { color: #c000c0; }
+.LineNr { }
+.Constant { color: #008787; }
+.SpecialChar { color: #d70000; }
+.Delimiter { color: #c000c0; }
+.muFunction { color: #af5f00; text-decoration: underline; }
+.muComment { color: #005faf; }
+-->
+</style>
+
+<script type='text/javascript'>
+<!--
+
+/* function to open any folds containing a jumped-to line before jumping to it */
+function JumpToLine()
+{
+  var lineNum;
+  lineNum = window.location.hash;
+  lineNum = lineNum.substr(1); /* strip off '#' */
+
+  if (lineNum.indexOf('L') == -1) {
+    lineNum = 'L'+lineNum;
+  }
+  var lineElem = document.getElementById(lineNum);
+  /* Always jump to new location even if the line was hidden inside a fold, or
+   * we corrected the raw number to a line ID.
+   */
+  if (lineElem) {
+    lineElem.scrollIntoView(true);
+  }
+  return true;
+}
+if ('onhashchange' in window) {
+  window.onhashchange = JumpToLine;
+}
+
+-->
+</script>
+</head>
+<body onload='JumpToLine();'>
+<a href='https://github.com/akkartik/mu/blob/main/baremetal/500clear-screen.mu'>https://github.com/akkartik/mu/blob/main/baremetal/500clear-screen.mu</a>
+<pre id='vimCodeElement'>
+<span id="L1" class="LineNr"> 1 </span><span class="PreProc">fn</span> <span class="muFunction"><a href='500clear-screen.mu.html#L1'>clear-screen</a></span> screen: (addr screen) <span class="Delimiter">{</span>
+<span id="L2" class="LineNr"> 2 </span>  <span class="PreProc">var</span> y/<span class="Constant">eax</span>: int <span class="SpecialChar">&lt;-</span> copy <span class="Constant">0</span>
+<span id="L3" class="LineNr"> 3 </span>  <span class="Delimiter">{</span>
+<span id="L4" class="LineNr"> 4 </span>    compare y, <span class="Constant">0x300</span>  <span class="muComment"># 768</span>
+<span id="L5" class="LineNr"> 5 </span>    <span class="PreProc">break-if-&gt;=</span>
+<span id="L6" class="LineNr"> 6 </span>    <span class="PreProc">var</span> x/<span class="Constant">edx</span>: int <span class="SpecialChar">&lt;-</span> copy <span class="Constant">0</span>
+<span id="L7" class="LineNr"> 7 </span>    <span class="Delimiter">{</span>
+<span id="L8" class="LineNr"> 8 </span>      compare x, <span class="Constant">0x400</span>  <span class="muComment"># 1024</span>
+<span id="L9" class="LineNr"> 9 </span>      <span class="PreProc">break-if-&gt;=</span>
+<span id="L10" class="LineNr">10 </span>      <a href='101screen.subx.html#L5'>pixel</a> <span class="Constant">0</span>, x, y, <span class="Constant">0</span>  <span class="muComment"># black</span>
+<span id="L11" class="LineNr">11 </span>      x <span class="SpecialChar">&lt;-</span> increment
+<span id="L12" class="LineNr">12 </span>      <span class="PreProc">loop</span>
+<span id="L13" class="LineNr">13 </span>    <span class="Delimiter">}</span>
+<span id="L14" class="LineNr">14 </span>    y <span class="SpecialChar">&lt;-</span> increment
+<span id="L15" class="LineNr">15 </span>    <span class="PreProc">loop</span>
+<span id="L16" class="LineNr">16 </span>  <span class="Delimiter">}</span>
+<span id="L17" class="LineNr">17 </span><span class="Delimiter">}</span>
+</pre>
+</body>
+</html>
+<!-- vim: set foldmethod=manual : -->
diff --git a/html/baremetal/501draw-text.mu.html b/html/baremetal/501draw-text.mu.html
index c877d08d..d57d46cb 100644
--- a/html/baremetal/501draw-text.mu.html
+++ b/html/baremetal/501draw-text.mu.html
@@ -61,60 +61,60 @@ if ('onhashchange' in window) {
 <span id="L3" class="LineNr">  3 </span><span class="PreProc">fn</span> <span class="muFunction"><a href='501draw-text.mu.html#L3'>cursor-left</a></span> screen: (addr screen) <span class="Delimiter">{</span>
 <span id="L4" class="LineNr">  4 </span>  <span class="PreProc">var</span> cursor-x/<span class="Constant">eax</span>: int <span class="SpecialChar">&lt;-</span> copy <span class="Constant">0</span>
 <span id="L5" class="LineNr">  5 </span>  <span class="PreProc">var</span> cursor-y/<span class="Constant">ecx</span>: int <span class="SpecialChar">&lt;-</span> copy <span class="Constant">0</span>
-<span id="L6" class="LineNr">  6 </span>  cursor-x, cursor-y <span class="SpecialChar">&lt;-</span> <a href='103grapheme.subx.html#L73'>cursor-position</a> screen
+<span id="L6" class="LineNr">  6 </span>  cursor-x, cursor-y <span class="SpecialChar">&lt;-</span> <a href='103grapheme.subx.html#L77'>cursor-position</a> screen
 <span id="L7" class="LineNr">  7 </span>  compare cursor-x, <span class="Constant">0</span>
 <span id="L8" class="LineNr">  8 </span>  <span class="Delimiter">{</span>
 <span id="L9" class="LineNr">  9 </span>    <span class="PreProc">break-if-&gt;</span>
 <span id="L10" class="LineNr"> 10 </span>    <span class="PreProc">return</span>
 <span id="L11" class="LineNr"> 11 </span>  <span class="Delimiter">}</span>
 <span id="L12" class="LineNr"> 12 </span>  cursor-x <span class="SpecialChar">&lt;-</span> subtract <span class="Constant">8</span>  <span class="muComment"># font-width</span>
-<span id="L13" class="LineNr"> 13 </span>  <a href='103grapheme.subx.html#L86'>set-cursor-position</a> screen, cursor-x, cursor-y
+<span id="L13" class="LineNr"> 13 </span>  <a href='103grapheme.subx.html#L90'>set-cursor-position</a> screen, cursor-x, cursor-y
 <span id="L14" class="LineNr"> 14 </span><span class="Delimiter">}</span>
 <span id="L15" class="LineNr"> 15 </span>
 <span id="L16" class="LineNr"> 16 </span><span class="PreProc">fn</span> <span class="muFunction"><a href='501draw-text.mu.html#L16'>cursor-right</a></span> screen: (addr screen) <span class="Delimiter">{</span>
 <span id="L17" class="LineNr"> 17 </span>  <span class="PreProc">var</span> cursor-x/<span class="Constant">eax</span>: int <span class="SpecialChar">&lt;-</span> copy <span class="Constant">0</span>
 <span id="L18" class="LineNr"> 18 </span>  <span class="PreProc">var</span> cursor-y/<span class="Constant">ecx</span>: int <span class="SpecialChar">&lt;-</span> copy <span class="Constant">0</span>
-<span id="L19" class="LineNr"> 19 </span>  cursor-x, cursor-y <span class="SpecialChar">&lt;-</span> <a href='103grapheme.subx.html#L73'>cursor-position</a> screen
+<span id="L19" class="LineNr"> 19 </span>  cursor-x, cursor-y <span class="SpecialChar">&lt;-</span> <a href='103grapheme.subx.html#L77'>cursor-position</a> screen
 <span id="L20" class="LineNr"> 20 </span>  compare cursor-x, <span class="Constant">0x400</span>  <span class="muComment"># screen-width</span>
 <span id="L21" class="LineNr"> 21 </span>  <span class="Delimiter">{</span>
 <span id="L22" class="LineNr"> 22 </span>    <span class="PreProc">break-if-&lt;</span>
 <span id="L23" class="LineNr"> 23 </span>    <span class="PreProc">return</span>
 <span id="L24" class="LineNr"> 24 </span>  <span class="Delimiter">}</span>
 <span id="L25" class="LineNr"> 25 </span>  cursor-x <span class="SpecialChar">&lt;-</span> add <span class="Constant">8</span>  <span class="muComment"># font-width</span>
-<span id="L26" class="LineNr"> 26 </span>  <a href='103grapheme.subx.html#L86'>set-cursor-position</a> screen, cursor-x, cursor-y
+<span id="L26" class="LineNr"> 26 </span>  <a href='103grapheme.subx.html#L90'>set-cursor-position</a> screen, cursor-x, cursor-y
 <span id="L27" class="LineNr"> 27 </span><span class="Delimiter">}</span>
 <span id="L28" class="LineNr"> 28 </span>
 <span id="L29" class="LineNr"> 29 </span><span class="PreProc">fn</span> <span class="muFunction"><a href='501draw-text.mu.html#L29'>cursor-up</a></span> screen: (addr screen) <span class="Delimiter">{</span>
 <span id="L30" class="LineNr"> 30 </span>  <span class="PreProc">var</span> cursor-x/<span class="Constant">eax</span>: int <span class="SpecialChar">&lt;-</span> copy <span class="Constant">0</span>
 <span id="L31" class="LineNr"> 31 </span>  <span class="PreProc">var</span> cursor-y/<span class="Constant">ecx</span>: int <span class="SpecialChar">&lt;-</span> copy <span class="Constant">0</span>
-<span id="L32" class="LineNr"> 32 </span>  cursor-x, cursor-y <span class="SpecialChar">&lt;-</span> <a href='103grapheme.subx.html#L73'>cursor-position</a> screen
+<span id="L32" class="LineNr"> 32 </span>  cursor-x, cursor-y <span class="SpecialChar">&lt;-</span> <a href='103grapheme.subx.html#L77'>cursor-position</a> screen
 <span id="L33" class="LineNr"> 33 </span>  compare cursor-y, <span class="Constant">0</span>
 <span id="L34" class="LineNr"> 34 </span>  <span class="Delimiter">{</span>
 <span id="L35" class="LineNr"> 35 </span>    <span class="PreProc">break-if-&gt;</span>
 <span id="L36" class="LineNr"> 36 </span>    <span class="PreProc">return</span>
 <span id="L37" class="LineNr"> 37 </span>  <span class="Delimiter">}</span>
 <span id="L38" class="LineNr"> 38 </span>  cursor-y <span class="SpecialChar">&lt;-</span> subtract <span class="Constant">0x10</span>  <span class="muComment"># screen-height</span>
-<span id="L39" class="LineNr"> 39 </span>  <a href='103grapheme.subx.html#L86'>set-cursor-position</a> screen, cursor-x, cursor-y
+<span id="L39" class="LineNr"> 39 </span>  <a href='103grapheme.subx.html#L90'>set-cursor-position</a> screen, cursor-x, cursor-y
 <span id="L40" class="LineNr"> 40 </span><span class="Delimiter">}</span>
 <span id="L41" class="LineNr"> 41 </span>
 <span id="L42" class="LineNr"> 42 </span><span class="PreProc">fn</span> <span class="muFunction"><a href='501draw-text.mu.html#L42'>cursor-down</a></span> screen: (addr screen) <span class="Delimiter">{</span>
 <span id="L43" class="LineNr"> 43 </span>  <span class="PreProc">var</span> cursor-x/<span class="Constant">eax</span>: int <span class="SpecialChar">&lt;-</span> copy <span class="Constant">0</span>
 <span id="L44" class="LineNr"> 44 </span>  <span class="PreProc">var</span> cursor-y/<span class="Constant">ecx</span>: int <span class="SpecialChar">&lt;-</span> copy <span class="Constant">0</span>
-<span id="L45" class="LineNr"> 45 </span>  cursor-x, cursor-y <span class="SpecialChar">&lt;-</span> <a href='103grapheme.subx.html#L73'>cursor-position</a> screen
+<span id="L45" class="LineNr"> 45 </span>  cursor-x, cursor-y <span class="SpecialChar">&lt;-</span> <a href='103grapheme.subx.html#L77'>cursor-position</a> screen
 <span id="L46" class="LineNr"> 46 </span>  compare cursor-y, <span class="Constant">0x300</span>  <span class="muComment"># screen-height</span>
 <span id="L47" class="LineNr"> 47 </span>  <span class="Delimiter">{</span>
 <span id="L48" class="LineNr"> 48 </span>    <span class="PreProc">break-if-&lt;</span>
 <span id="L49" class="LineNr"> 49 </span>    <span class="PreProc">return</span>
 <span id="L50" class="LineNr"> 50 </span>  <span class="Delimiter">}</span>
 <span id="L51" class="LineNr"> 51 </span>  cursor-y <span class="SpecialChar">&lt;-</span> add <span class="Constant">0x10</span>  <span class="muComment"># screen-height</span>
-<span id="L52" class="LineNr"> 52 </span>  <a href='103grapheme.subx.html#L86'>set-cursor-position</a> screen, cursor-x, cursor-y
+<span id="L52" class="LineNr"> 52 </span>  <a href='103grapheme.subx.html#L90'>set-cursor-position</a> screen, cursor-x, cursor-y
 <span id="L53" class="LineNr"> 53 </span><span class="Delimiter">}</span>
 <span id="L54" class="LineNr"> 54 </span>
 <span id="L55" class="LineNr"> 55 </span><span class="PreProc">fn</span> <span class="muFunction"><a href='501draw-text.mu.html#L55'>draw-grapheme-at-cursor</a></span> screen: (addr screen), g: grapheme, color: int <span class="Delimiter">{</span>
 <span id="L56" class="LineNr"> 56 </span>  <span class="PreProc">var</span> cursor-x/<span class="Constant">eax</span>: int <span class="SpecialChar">&lt;-</span> copy <span class="Constant">0</span>
 <span id="L57" class="LineNr"> 57 </span>  <span class="PreProc">var</span> cursor-y/<span class="Constant">ecx</span>: int <span class="SpecialChar">&lt;-</span> copy <span class="Constant">0</span>
-<span id="L58" class="LineNr"> 58 </span>  cursor-x, cursor-y <span class="SpecialChar">&lt;-</span> <a href='103grapheme.subx.html#L73'>cursor-position</a> screen
-<span id="L59" class="LineNr"> 59 </span>  <a href='103grapheme.subx.html#L1'>draw-grapheme</a> screen, g, cursor-x, cursor-y, color
+<span id="L58" class="LineNr"> 58 </span>  cursor-x, cursor-y <span class="SpecialChar">&lt;-</span> <a href='103grapheme.subx.html#L77'>cursor-position</a> screen
+<span id="L59" class="LineNr"> 59 </span>  <a href='103grapheme.subx.html#L5'>draw-grapheme</a> screen, g, cursor-x, cursor-y, color
 <span id="L60" class="LineNr"> 60 </span><span class="Delimiter">}</span>
 <span id="L61" class="LineNr"> 61 </span>
 <span id="L62" class="LineNr"> 62 </span><span class="muComment"># draw a single line of text from x, y to xmax</span>
@@ -123,7 +123,7 @@ if ('onhashchange' in window) {
 <span id="L65" class="LineNr"> 65 </span><span class="PreProc">fn</span> <span class="muFunction"><a href='501draw-text.mu.html#L65'>draw-text-rightward</a></span> screen: (addr screen), text: (addr array byte), x: int, xmax: int, y: int, color: int<span class="PreProc"> -&gt; </span>_/<span class="Constant">eax</span>: int <span class="Delimiter">{</span>
 <span id="L66" class="LineNr"> 66 </span>  <span class="PreProc">var</span> stream-storage: (stream byte <span class="Constant">0x100</span>)
 <span id="L67" class="LineNr"> 67 </span>  <span class="PreProc">var</span> stream/<span class="Constant">esi</span>: (addr stream byte) <span class="SpecialChar">&lt;-</span> address stream-storage
-<span id="L68" class="LineNr"> 68 </span>  <a href='108write.subx.html#L5'>write</a> stream, text
+<span id="L68" class="LineNr"> 68 </span>  <a href='108write.subx.html#L6'>write</a> stream, text
 <span id="L69" class="LineNr"> 69 </span>  <span class="muComment"># check if we have enough space</span>
 <span id="L70" class="LineNr"> 70 </span>  <span class="PreProc">var</span> xcurr/<span class="Constant">ecx</span>: int <span class="SpecialChar">&lt;-</span> copy x
 <span id="L71" class="LineNr"> 71 </span>  <span class="Delimiter">{</span>
@@ -147,18 +147,18 @@ if ('onhashchange' in window) {
 <span id="L89" class="LineNr"> 89 </span>    <span class="PreProc">var</span> g/<span class="Constant">eax</span>: grapheme <span class="SpecialChar">&lt;-</span> <a href='403unicode.mu.html#L92'>read-grapheme</a> stream
 <span id="L90" class="LineNr"> 90 </span>    compare g, <span class="Constant">0xffffffff</span>  <span class="muComment"># end-of-file</span>
 <span id="L91" class="LineNr"> 91 </span>    <span class="PreProc">break-if-=</span>
-<span id="L92" class="LineNr"> 92 </span>    <a href='103grapheme.subx.html#L1'>draw-grapheme</a> screen, g, xcurr, y, color
+<span id="L92" class="LineNr"> 92 </span>    <a href='103grapheme.subx.html#L5'>draw-grapheme</a> screen, g, xcurr, y, color
 <span id="L93" class="LineNr"> 93 </span>    xcurr <span class="SpecialChar">&lt;-</span> add <span class="Constant">8</span>  <span class="muComment"># font-width</span>
 <span id="L94" class="LineNr"> 94 </span>    <span class="PreProc">loop</span>
 <span id="L95" class="LineNr"> 95 </span>  <span class="Delimiter">}</span>
-<span id="L96" class="LineNr"> 96 </span>  <a href='103grapheme.subx.html#L86'>set-cursor-position</a> screen, xcurr, y
+<span id="L96" class="LineNr"> 96 </span>  <a href='103grapheme.subx.html#L90'>set-cursor-position</a> screen, xcurr, y
 <span id="L97" class="LineNr"> 97 </span>  <span class="PreProc">return</span> xcurr
 <span id="L98" class="LineNr"> 98 </span><span class="Delimiter">}</span>
 <span id="L99" class="LineNr"> 99 </span>
 <span id="L100" class="LineNr">100 </span><span class="PreProc">fn</span> <span class="muFunction"><a href='501draw-text.mu.html#L100'>draw-text-rightward-from-cursor</a></span> screen: (addr screen), text: (addr array byte), xmax: int, color: int<span class="PreProc"> -&gt; </span>_/<span class="Constant">eax</span>: int <span class="Delimiter">{</span>
 <span id="L101" class="LineNr">101 </span>  <span class="PreProc">var</span> cursor-x/<span class="Constant">eax</span>: int <span class="SpecialChar">&lt;-</span> copy <span class="Constant">0</span>
 <span id="L102" class="LineNr">102 </span>  <span class="PreProc">var</span> cursor-y/<span class="Constant">ecx</span>: int <span class="SpecialChar">&lt;-</span> copy <span class="Constant">0</span>
-<span id="L103" class="LineNr">103 </span>  cursor-x, cursor-y <span class="SpecialChar">&lt;-</span> <a href='103grapheme.subx.html#L73'>cursor-position</a> screen
+<span id="L103" class="LineNr">103 </span>  cursor-x, cursor-y <span class="SpecialChar">&lt;-</span> <a href='103grapheme.subx.html#L77'>cursor-position</a> screen
 <span id="L104" class="LineNr">104 </span>  <span class="PreProc">var</span> result/<span class="Constant">eax</span>: int <span class="SpecialChar">&lt;-</span> <a href='501draw-text.mu.html#L65'>draw-text-rightward</a> screen, text, cursor-x, xmax, cursor-y, color
 <span id="L105" class="LineNr">105 </span>  <span class="PreProc">return</span> result
 <span id="L106" class="LineNr">106 </span><span class="Delimiter">}</span>
@@ -170,7 +170,7 @@ if ('onhashchange' in window) {
 <span id="L112" class="LineNr">112 </span><span class="PreProc">fn</span> <span class="muFunction"><a href='501draw-text.mu.html#L112'>draw-text-wrapping-right-then-down</a></span> screen: (addr screen), text: (addr array byte), xmin: int, ymin: int, xmax: int, ymax: int, x: int, y: int, color: int<span class="PreProc"> -&gt; </span>_/<span class="Constant">eax</span>: int, _/<span class="Constant">ecx</span>: int <span class="Delimiter">{</span>
 <span id="L113" class="LineNr">113 </span>  <span class="PreProc">var</span> stream-storage: (stream byte <span class="Constant">0x100</span>)
 <span id="L114" class="LineNr">114 </span>  <span class="PreProc">var</span> stream/<span class="Constant">esi</span>: (addr stream byte) <span class="SpecialChar">&lt;-</span> address stream-storage
-<span id="L115" class="LineNr">115 </span>  <a href='108write.subx.html#L5'>write</a> stream, text
+<span id="L115" class="LineNr">115 </span>  <a href='108write.subx.html#L6'>write</a> stream, text
 <span id="L116" class="LineNr">116 </span>  <span class="muComment"># check if we have enough space</span>
 <span id="L117" class="LineNr">117 </span>  <span class="PreProc">var</span> xcurr/<span class="Constant">edx</span>: int <span class="SpecialChar">&lt;-</span> copy x
 <span id="L118" class="LineNr">118 </span>  <span class="PreProc">var</span> ycurr/<span class="Constant">ecx</span>: int <span class="SpecialChar">&lt;-</span> copy y
@@ -202,7 +202,7 @@ if ('onhashchange' in window) {
 <span id="L144" class="LineNr">144 </span>    <span class="PreProc">var</span> g/<span class="Constant">eax</span>: grapheme <span class="SpecialChar">&lt;-</span> <a href='403unicode.mu.html#L92'>read-grapheme</a> stream
 <span id="L145" class="LineNr">145 </span>    compare g, <span class="Constant">0xffffffff</span>  <span class="muComment"># end-of-file</span>
 <span id="L146" class="LineNr">146 </span>    <span class="PreProc">break-if-=</span>
-<span id="L147" class="LineNr">147 </span>    <a href='103grapheme.subx.html#L1'>draw-grapheme</a> screen, g, xcurr, ycurr, color
+<span id="L147" class="LineNr">147 </span>    <a href='103grapheme.subx.html#L5'>draw-grapheme</a> screen, g, xcurr, ycurr, color
 <span id="L148" class="LineNr">148 </span>    xcurr <span class="SpecialChar">&lt;-</span> add <span class="Constant">8</span>  <span class="muComment"># font-width</span>
 <span id="L149" class="LineNr">149 </span>    compare xcurr, xmax
 <span id="L150" class="LineNr">150 </span>    <span class="Delimiter">{</span>
@@ -212,7 +212,7 @@ if ('onhashchange' in window) {
 <span id="L154" class="LineNr">154 </span>    <span class="Delimiter">}</span>
 <span id="L155" class="LineNr">155 </span>    <span class="PreProc">loop</span>
 <span id="L156" class="LineNr">156 </span>  <span class="Delimiter">}</span>
-<span id="L157" class="LineNr">157 </span>  <a href='103grapheme.subx.html#L86'>set-cursor-position</a> screen, xcurr, ycurr
+<span id="L157" class="LineNr">157 </span>  <a href='103grapheme.subx.html#L90'>set-cursor-position</a> screen, xcurr, ycurr
 <span id="L158" class="LineNr">158 </span>  <span class="PreProc">return</span> xcurr, ycurr
 <span id="L159" class="LineNr">159 </span><span class="Delimiter">}</span>
 <span id="L160" class="LineNr">160 </span>
@@ -223,10 +223,10 @@ if ('onhashchange' in window) {
 <span id="L165" class="LineNr">165 </span>  <span class="PreProc">return</span> cursor-x, cursor-y
 <span id="L166" class="LineNr">166 </span><span class="Delimiter">}</span>
 <span id="L167" class="LineNr">167 </span>
-<span id="L168" class="LineNr">168 </span><span class="PreProc">fn</span> <span class="muFunction"><a href='501draw-text.mu.html#L168'>draw-text-wrapping-right-then-down-from-cursor</a></span> screen: (addr screen), text: (addr array byte), xmin: int, ymin: int, xmax: int, ymax: int, color: int<span class="PreProc"> -&gt; </span>_/<span class="Constant">eax</span>: int, _/<span class="Constant">ecx</span>: int <span class="Delimiter">{</span>
+<span id="L168" class="LineNr">168 </span><span class="PreProc">fn</span> <span class="muFunction"><a href='501draw-text.mu.html#L168'>draw-text-wrapping-right-then-down-from-cursor</a></span> screen: (addr screen), text: (addr array byte), xmin: int, ymin: int, xmax: int, ymax: int, color: int <span class="Delimiter">{</span>
 <span id="L169" class="LineNr">169 </span>  <span class="PreProc">var</span> cursor-x/<span class="Constant">eax</span>: int <span class="SpecialChar">&lt;-</span> copy <span class="Constant">0</span>
 <span id="L170" class="LineNr">170 </span>  <span class="PreProc">var</span> cursor-y/<span class="Constant">ecx</span>: int <span class="SpecialChar">&lt;-</span> copy <span class="Constant">0</span>
-<span id="L171" class="LineNr">171 </span>  cursor-x, cursor-y <span class="SpecialChar">&lt;-</span> <a href='103grapheme.subx.html#L73'>cursor-position</a> screen
+<span id="L171" class="LineNr">171 </span>  cursor-x, cursor-y <span class="SpecialChar">&lt;-</span> <a href='103grapheme.subx.html#L77'>cursor-position</a> screen
 <span id="L172" class="LineNr">172 </span>  <span class="PreProc">var</span> end-x/<span class="Constant">edx</span>: int <span class="SpecialChar">&lt;-</span> copy cursor-x
 <span id="L173" class="LineNr">173 </span>  end-x <span class="SpecialChar">&lt;-</span> add <span class="Constant">8</span>  <span class="muComment"># font-width</span>
 <span id="L174" class="LineNr">174 </span>  compare end-x, xmax
@@ -236,146 +236,137 @@ if ('onhashchange' in window) {
 <span id="L178" class="LineNr">178 </span>    cursor-y <span class="SpecialChar">&lt;-</span> add <span class="Constant">0x10</span>  <span class="muComment"># font-height</span>
 <span id="L179" class="LineNr">179 </span>  <span class="Delimiter">}</span>
 <span id="L180" class="LineNr">180 </span>  cursor-x, cursor-y <span class="SpecialChar">&lt;-</span> <a href='501draw-text.mu.html#L112'>draw-text-wrapping-right-then-down</a> screen, text, xmin, ymin, xmax, ymax, cursor-x, cursor-y, color
-<span id="L181" class="LineNr">181 </span>  <span class="PreProc">return</span> cursor-x, cursor-y
-<span id="L182" class="LineNr">182 </span><span class="Delimiter">}</span>
-<span id="L183" class="LineNr">183 </span>
-<span id="L184" class="LineNr">184 </span><span class="PreProc">fn</span> <span class="muFunction"><a href='501draw-text.mu.html#L184'>draw-text-wrapping-right-then-down-from-cursor-over-full-screen</a></span> screen: (addr screen), text: (addr array byte), color: int<span class="PreProc"> -&gt; </span>_/<span class="Constant">eax</span>: int, _/<span class="Constant">ecx</span>: int <span class="Delimiter">{</span>
-<span id="L185" class="LineNr">185 </span>  <span class="PreProc">var</span> cursor-x/<span class="Constant">eax</span>: int <span class="SpecialChar">&lt;-</span> copy <span class="Constant">0</span>
-<span id="L186" class="LineNr">186 </span>  <span class="PreProc">var</span> cursor-y/<span class="Constant">ecx</span>: int <span class="SpecialChar">&lt;-</span> copy <span class="Constant">0</span>
-<span id="L187" class="LineNr">187 </span>  cursor-x, cursor-y <span class="SpecialChar">&lt;-</span> <a href='501draw-text.mu.html#L168'>draw-text-wrapping-right-then-down-from-cursor</a> screen, text, <span class="Constant">0</span>, <span class="Constant">0</span>, <span class="Constant">0x400</span>, <span class="Constant">0x300</span>, color  <span class="muComment"># 1024, 768</span>
-<span id="L188" class="LineNr">188 </span>  <span class="PreProc">return</span> cursor-x, cursor-y
-<span id="L189" class="LineNr">189 </span><span class="Delimiter">}</span>
-<span id="L190" class="LineNr">190 </span>
-<span id="L191" class="LineNr">191 </span><span class="muComment">## Text direction: down then right</span>
-<span id="L192" class="LineNr">192 </span>
-<span id="L193" class="LineNr">193 </span><span class="muComment"># draw a single line of text vertically from x, y to ymax</span>
-<span id="L194" class="LineNr">194 </span><span class="muComment"># return the next 'y' coordinate</span>
-<span id="L195" class="LineNr">195 </span><span class="muComment"># if there isn't enough space, return 0 without modifying the screen</span>
-<span id="L196" class="LineNr">196 </span><span class="PreProc">fn</span> <span class="muFunction"><a href='501draw-text.mu.html#L196'>draw-text-downward</a></span> screen: (addr screen), text: (addr array byte), x: int, y: int, ymax: int, color: int<span class="PreProc"> -&gt; </span>_/<span class="Constant">eax</span>: int <span class="Delimiter">{</span>
-<span id="L197" class="LineNr">197 </span>  <span class="PreProc">var</span> stream-storage: (stream byte <span class="Constant">0x100</span>)
-<span id="L198" class="LineNr">198 </span>  <span class="PreProc">var</span> stream/<span class="Constant">esi</span>: (addr stream byte) <span class="SpecialChar">&lt;-</span> address stream-storage
-<span id="L199" class="LineNr">199 </span>  <a href='108write.subx.html#L5'>write</a> stream, text
-<span id="L200" class="LineNr">200 </span>  <span class="muComment"># check if we have enough space</span>
-<span id="L201" class="LineNr">201 </span>  <span class="PreProc">var</span> ycurr/<span class="Constant">ecx</span>: int <span class="SpecialChar">&lt;-</span> copy y
-<span id="L202" class="LineNr">202 </span>  <span class="Delimiter">{</span>
-<span id="L203" class="LineNr">203 </span>    compare ycurr, ymax
-<span id="L204" class="LineNr">204 </span>    <span class="PreProc">break-if-&gt;</span>
-<span id="L205" class="LineNr">205 </span>    <span class="PreProc">var</span> g/<span class="Constant">eax</span>: grapheme <span class="SpecialChar">&lt;-</span> <a href='403unicode.mu.html#L92'>read-grapheme</a> stream
-<span id="L206" class="LineNr">206 </span>    compare g, <span class="Constant">0xffffffff</span>  <span class="muComment"># end-of-file</span>
-<span id="L207" class="LineNr">207 </span>    <span class="PreProc">break-if-=</span>
-<span id="L208" class="LineNr">208 </span>    ycurr <span class="SpecialChar">&lt;-</span> add <span class="Constant">0x10</span>  <span class="muComment"># font-height</span>
-<span id="L209" class="LineNr">209 </span>    <span class="PreProc">loop</span>
-<span id="L210" class="LineNr">210 </span>  <span class="Delimiter">}</span>
-<span id="L211" class="LineNr">211 </span>  compare ycurr, ymax
-<span id="L212" class="LineNr">212 </span>  <span class="Delimiter">{</span>
-<span id="L213" class="LineNr">213 </span>    <span class="PreProc">break-if-&lt;=</span>
-<span id="L214" class="LineNr">214 </span>    <span class="PreProc">return</span> <span class="Constant">0</span>
-<span id="L215" class="LineNr">215 </span>  <span class="Delimiter">}</span>
-<span id="L216" class="LineNr">216 </span>  <span class="muComment"># we do; actually draw</span>
-<span id="L217" class="LineNr">217 </span>  <a href='106stream.subx.html#L56'>rewind-stream</a> stream
-<span id="L218" class="LineNr">218 </span>  ycurr <span class="SpecialChar">&lt;-</span> copy y
-<span id="L219" class="LineNr">219 </span>  <span class="Delimiter">{</span>
-<span id="L220" class="LineNr">220 </span>    <span class="PreProc">var</span> g/<span class="Constant">eax</span>: grapheme <span class="SpecialChar">&lt;-</span> <a href='403unicode.mu.html#L92'>read-grapheme</a> stream
-<span id="L221" class="LineNr">221 </span>    compare g, <span class="Constant">0xffffffff</span>  <span class="muComment"># end-of-file</span>
-<span id="L222" class="LineNr">222 </span>    <span class="PreProc">break-if-=</span>
-<span id="L223" class="LineNr">223 </span>    <a href='103grapheme.subx.html#L1'>draw-grapheme</a> screen, g, x, ycurr, color
-<span id="L224" class="LineNr">224 </span>    ycurr <span class="SpecialChar">&lt;-</span> add <span class="Constant">0x10</span>  <span class="muComment"># font-height</span>
-<span id="L225" class="LineNr">225 </span>    <span class="PreProc">loop</span>
-<span id="L226" class="LineNr">226 </span>  <span class="Delimiter">}</span>
-<span id="L227" class="LineNr">227 </span>  <a href='103grapheme.subx.html#L86'>set-cursor-position</a> screen, x, ycurr
-<span id="L228" class="LineNr">228 </span>  <span class="PreProc">return</span> ycurr
-<span id="L229" class="LineNr">229 </span><span class="Delimiter">}</span>
-<span id="L230" class="LineNr">230 </span>
-<span id="L231" class="LineNr">231 </span><span class="PreProc">fn</span> <span class="muFunction"><a href='501draw-text.mu.html#L231'>draw-text-downward-from-cursor</a></span> screen: (addr screen), text: (addr array byte), ymax: int, color: int<span class="PreProc"> -&gt; </span>_/<span class="Constant">eax</span>: int <span class="Delimiter">{</span>
-<span id="L232" class="LineNr">232 </span>  <span class="PreProc">var</span> cursor-x/<span class="Constant">eax</span>: int <span class="SpecialChar">&lt;-</span> copy <span class="Constant">0</span>
-<span id="L233" class="LineNr">233 </span>  <span class="PreProc">var</span> cursor-y/<span class="Constant">ecx</span>: int <span class="SpecialChar">&lt;-</span> copy <span class="Constant">0</span>
-<span id="L234" class="LineNr">234 </span>  cursor-x, cursor-y <span class="SpecialChar">&lt;-</span> <a href='103grapheme.subx.html#L73'>cursor-position</a> screen
-<span id="L235" class="LineNr">235 </span>  <span class="PreProc">var</span> result/<span class="Constant">eax</span>: int <span class="SpecialChar">&lt;-</span> <a href='501draw-text.mu.html#L196'>draw-text-downward</a> screen, text, cursor-x, cursor-y, ymax, color
-<span id="L236" class="LineNr">236 </span>  <span class="PreProc">return</span> result
-<span id="L237" class="LineNr">237 </span><span class="Delimiter">}</span>
-<span id="L238" class="LineNr">238 </span>
-<span id="L239" class="LineNr">239 </span><span class="muComment"># draw text down and right in the rectangle from (xmin, ymin) to (xmax, ymax), starting from (x, y), wrapping as necessary</span>
-<span id="L240" class="LineNr">240 </span><span class="muComment"># return the next (x, y) coordinate in raster order where drawing stopped</span>
-<span id="L241" class="LineNr">241 </span><span class="muComment"># that way the caller can draw more if given the same min and max bounding-box.</span>
-<span id="L242" class="LineNr">242 </span><span class="muComment"># if there isn't enough space, return 0 without modifying the screen</span>
-<span id="L243" class="LineNr">243 </span><span class="PreProc">fn</span> <span class="muFunction"><a href='501draw-text.mu.html#L243'>draw-text-wrapping-down-then-right</a></span> screen: (addr screen), text: (addr array byte), xmin: int, ymin: int, xmax: int, ymax: int, x: int, y: int, color: int<span class="PreProc"> -&gt; </span>_/<span class="Constant">eax</span>: int, _/<span class="Constant">ecx</span>: int <span class="Delimiter">{</span>
-<span id="L244" class="LineNr">244 </span>  <span class="PreProc">var</span> stream-storage: (stream byte <span class="Constant">0x100</span>)
-<span id="L245" class="LineNr">245 </span>  <span class="PreProc">var</span> stream/<span class="Constant">esi</span>: (addr stream byte) <span class="SpecialChar">&lt;-</span> address stream-storage
-<span id="L246" class="LineNr">246 </span>  <a href='108write.subx.html#L5'>write</a> stream, text
-<span id="L247" class="LineNr">247 </span>  <span class="muComment"># check if we have enough space</span>
-<span id="L248" class="LineNr">248 </span>  <span class="PreProc">var</span> xcurr/<span class="Constant">edx</span>: int <span class="SpecialChar">&lt;-</span> copy x
-<span id="L249" class="LineNr">249 </span>  <span class="PreProc">var</span> ycurr/<span class="Constant">ecx</span>: int <span class="SpecialChar">&lt;-</span> copy y
-<span id="L250" class="LineNr">250 </span>  <span class="Delimiter">{</span>
-<span id="L251" class="LineNr">251 </span>    compare xcurr, xmax
-<span id="L252" class="LineNr">252 </span>    <span class="PreProc">break-if-&gt;=</span>
-<span id="L253" class="LineNr">253 </span>    <span class="PreProc">var</span> g/<span class="Constant">eax</span>: grapheme <span class="SpecialChar">&lt;-</span> <a href='403unicode.mu.html#L92'>read-grapheme</a> stream
-<span id="L254" class="LineNr">254 </span>    compare g, <span class="Constant">0xffffffff</span>  <span class="muComment"># end-of-file</span>
-<span id="L255" class="LineNr">255 </span>    <span class="PreProc">break-if-=</span>
-<span id="L256" class="LineNr">256 </span>    ycurr <span class="SpecialChar">&lt;-</span> add <span class="Constant">0x10</span>  <span class="muComment"># font-height</span>
-<span id="L257" class="LineNr">257 </span>    compare ycurr, ymax
-<span id="L258" class="LineNr">258 </span>    <span class="Delimiter">{</span>
-<span id="L259" class="LineNr">259 </span>      <span class="PreProc">break-if-&lt;</span>
-<span id="L260" class="LineNr">260 </span>      xcurr <span class="SpecialChar">&lt;-</span> add <span class="Constant">8</span>  <span class="muComment"># font-width</span>
-<span id="L261" class="LineNr">261 </span>      ycurr <span class="SpecialChar">&lt;-</span> copy ymin
-<span id="L262" class="LineNr">262 </span>    <span class="Delimiter">}</span>
-<span id="L263" class="LineNr">263 </span>    <span class="PreProc">loop</span>
+<span id="L181" class="LineNr">181 </span><span class="Delimiter">}</span>
+<span id="L182" class="LineNr">182 </span>
+<span id="L183" class="LineNr">183 </span><span class="PreProc">fn</span> <span class="muFunction"><a href='501draw-text.mu.html#L183'>draw-text-wrapping-right-then-down-from-cursor-over-full-screen</a></span> screen: (addr screen), text: (addr array byte), color: int <span class="Delimiter">{</span>
+<span id="L184" class="LineNr">184 </span>  <a href='501draw-text.mu.html#L168'>draw-text-wrapping-right-then-down-from-cursor</a> screen, text, <span class="Constant">0</span>, <span class="Constant">0</span>, <span class="Constant">0x400</span>, <span class="Constant">0x300</span>, color  <span class="muComment"># 1024, 768</span>
+<span id="L185" class="LineNr">185 </span><span class="Delimiter">}</span>
+<span id="L186" class="LineNr">186 </span>
+<span id="L187" class="LineNr">187 </span><span class="muComment">## Text direction: down then right</span>
+<span id="L188" class="LineNr">188 </span>
+<span id="L189" class="LineNr">189 </span><span class="muComment"># draw a single line of text vertically from x, y to ymax</span>
+<span id="L190" class="LineNr">190 </span><span class="muComment"># return the next 'y' coordinate</span>
+<span id="L191" class="LineNr">191 </span><span class="muComment"># if there isn't enough space, return 0 without modifying the screen</span>
+<span id="L192" class="LineNr">192 </span><span class="PreProc">fn</span> <span class="muFunction"><a href='501draw-text.mu.html#L192'>draw-text-downward</a></span> screen: (addr screen), text: (addr array byte), x: int, y: int, ymax: int, color: int<span class="PreProc"> -&gt; </span>_/<span class="Constant">eax</span>: int <span class="Delimiter">{</span>
+<span id="L193" class="LineNr">193 </span>  <span class="PreProc">var</span> stream-storage: (stream byte <span class="Constant">0x100</span>)
+<span id="L194" class="LineNr">194 </span>  <span class="PreProc">var</span> stream/<span class="Constant">esi</span>: (addr stream byte) <span class="SpecialChar">&lt;-</span> address stream-storage
+<span id="L195" class="LineNr">195 </span>  <a href='108write.subx.html#L6'>write</a> stream, text
+<span id="L196" class="LineNr">196 </span>  <span class="muComment"># check if we have enough space</span>
+<span id="L197" class="LineNr">197 </span>  <span class="PreProc">var</span> ycurr/<span class="Constant">ecx</span>: int <span class="SpecialChar">&lt;-</span> copy y
+<span id="L198" class="LineNr">198 </span>  <span class="Delimiter">{</span>
+<span id="L199" class="LineNr">199 </span>    compare ycurr, ymax
+<span id="L200" class="LineNr">200 </span>    <span class="PreProc">break-if-&gt;</span>
+<span id="L201" class="LineNr">201 </span>    <span class="PreProc">var</span> g/<span class="Constant">eax</span>: grapheme <span class="SpecialChar">&lt;-</span> <a href='403unicode.mu.html#L92'>read-grapheme</a> stream
+<span id="L202" class="LineNr">202 </span>    compare g, <span class="Constant">0xffffffff</span>  <span class="muComment"># end-of-file</span>
+<span id="L203" class="LineNr">203 </span>    <span class="PreProc">break-if-=</span>
+<span id="L204" class="LineNr">204 </span>    ycurr <span class="SpecialChar">&lt;-</span> add <span class="Constant">0x10</span>  <span class="muComment"># font-height</span>
+<span id="L205" class="LineNr">205 </span>    <span class="PreProc">loop</span>
+<span id="L206" class="LineNr">206 </span>  <span class="Delimiter">}</span>
+<span id="L207" class="LineNr">207 </span>  compare ycurr, ymax
+<span id="L208" class="LineNr">208 </span>  <span class="Delimiter">{</span>
+<span id="L209" class="LineNr">209 </span>    <span class="PreProc">break-if-&lt;=</span>
+<span id="L210" class="LineNr">210 </span>    <span class="PreProc">return</span> <span class="Constant">0</span>
+<span id="L211" class="LineNr">211 </span>  <span class="Delimiter">}</span>
+<span id="L212" class="LineNr">212 </span>  <span class="muComment"># we do; actually draw</span>
+<span id="L213" class="LineNr">213 </span>  <a href='106stream.subx.html#L56'>rewind-stream</a> stream
+<span id="L214" class="LineNr">214 </span>  ycurr <span class="SpecialChar">&lt;-</span> copy y
+<span id="L215" class="LineNr">215 </span>  <span class="Delimiter">{</span>
+<span id="L216" class="LineNr">216 </span>    <span class="PreProc">var</span> g/<span class="Constant">eax</span>: grapheme <span class="SpecialChar">&lt;-</span> <a href='403unicode.mu.html#L92'>read-grapheme</a> stream
+<span id="L217" class="LineNr">217 </span>    compare g, <span class="Constant">0xffffffff</span>  <span class="muComment"># end-of-file</span>
+<span id="L218" class="LineNr">218 </span>    <span class="PreProc">break-if-=</span>
+<span id="L219" class="LineNr">219 </span>    <a href='103grapheme.subx.html#L5'>draw-grapheme</a> screen, g, x, ycurr, color
+<span id="L220" class="LineNr">220 </span>    ycurr <span class="SpecialChar">&lt;-</span> add <span class="Constant">0x10</span>  <span class="muComment"># font-height</span>
+<span id="L221" class="LineNr">221 </span>    <span class="PreProc">loop</span>
+<span id="L222" class="LineNr">222 </span>  <span class="Delimiter">}</span>
+<span id="L223" class="LineNr">223 </span>  <a href='103grapheme.subx.html#L90'>set-cursor-position</a> screen, x, ycurr
+<span id="L224" class="LineNr">224 </span>  <span class="PreProc">return</span> ycurr
+<span id="L225" class="LineNr">225 </span><span class="Delimiter">}</span>
+<span id="L226" class="LineNr">226 </span>
+<span id="L227" class="LineNr">227 </span><span class="PreProc">fn</span> <span class="muFunction"><a href='501draw-text.mu.html#L227'>draw-text-downward-from-cursor</a></span> screen: (addr screen), text: (addr array byte), ymax: int, color: int <span class="Delimiter">{</span>
+<span id="L228" class="LineNr">228 </span>  <span class="PreProc">var</span> cursor-x/<span class="Constant">eax</span>: int <span class="SpecialChar">&lt;-</span> copy <span class="Constant">0</span>
+<span id="L229" class="LineNr">229 </span>  <span class="PreProc">var</span> cursor-y/<span class="Constant">ecx</span>: int <span class="SpecialChar">&lt;-</span> copy <span class="Constant">0</span>
+<span id="L230" class="LineNr">230 </span>  cursor-x, cursor-y <span class="SpecialChar">&lt;-</span> <a href='103grapheme.subx.html#L77'>cursor-position</a> screen
+<span id="L231" class="LineNr">231 </span>  <span class="PreProc">var</span> result/<span class="Constant">eax</span>: int <span class="SpecialChar">&lt;-</span> <a href='501draw-text.mu.html#L192'>draw-text-downward</a> screen, text, cursor-x, cursor-y, ymax, color
+<span id="L232" class="LineNr">232 </span><span class="Delimiter">}</span>
+<span id="L233" class="LineNr">233 </span>
+<span id="L234" class="LineNr">234 </span><span class="muComment"># draw text down and right in the rectangle from (xmin, ymin) to (xmax, ymax), starting from (x, y), wrapping as necessary</span>
+<span id="L235" class="LineNr">235 </span><span class="muComment"># return the next (x, y) coordinate in raster order where drawing stopped</span>
+<span id="L236" class="LineNr">236 </span><span class="muComment"># that way the caller can draw more if given the same min and max bounding-box.</span>
+<span id="L237" class="LineNr">237 </span><span class="muComment"># if there isn't enough space, return 0 without modifying the screen</span>
+<span id="L238" class="LineNr">238 </span><span class="PreProc">fn</span> <span class="muFunction"><a href='501draw-text.mu.html#L238'>draw-text-wrapping-down-then-right</a></span> screen: (addr screen), text: (addr array byte), xmin: int, ymin: int, xmax: int, ymax: int, x: int, y: int, color: int<span class="PreProc"> -&gt; </span>_/<span class="Constant">eax</span>: int, _/<span class="Constant">ecx</span>: int <span class="Delimiter">{</span>
+<span id="L239" class="LineNr">239 </span>  <span class="PreProc">var</span> stream-storage: (stream byte <span class="Constant">0x100</span>)
+<span id="L240" class="LineNr">240 </span>  <span class="PreProc">var</span> stream/<span class="Constant">esi</span>: (addr stream byte) <span class="SpecialChar">&lt;-</span> address stream-storage
+<span id="L241" class="LineNr">241 </span>  <a href='108write.subx.html#L6'>write</a> stream, text
+<span id="L242" class="LineNr">242 </span>  <span class="muComment"># check if we have enough space</span>
+<span id="L243" class="LineNr">243 </span>  <span class="PreProc">var</span> xcurr/<span class="Constant">edx</span>: int <span class="SpecialChar">&lt;-</span> copy x
+<span id="L244" class="LineNr">244 </span>  <span class="PreProc">var</span> ycurr/<span class="Constant">ecx</span>: int <span class="SpecialChar">&lt;-</span> copy y
+<span id="L245" class="LineNr">245 </span>  <span class="Delimiter">{</span>
+<span id="L246" class="LineNr">246 </span>    compare xcurr, xmax
+<span id="L247" class="LineNr">247 </span>    <span class="PreProc">break-if-&gt;=</span>
+<span id="L248" class="LineNr">248 </span>    <span class="PreProc">var</span> g/<span class="Constant">eax</span>: grapheme <span class="SpecialChar">&lt;-</span> <a href='403unicode.mu.html#L92'>read-grapheme</a> stream
+<span id="L249" class="LineNr">249 </span>    compare g, <span class="Constant">0xffffffff</span>  <span class="muComment"># end-of-file</span>
+<span id="L250" class="LineNr">250 </span>    <span class="PreProc">break-if-=</span>
+<span id="L251" class="LineNr">251 </span>    ycurr <span class="SpecialChar">&lt;-</span> add <span class="Constant">0x10</span>  <span class="muComment"># font-height</span>
+<span id="L252" class="LineNr">252 </span>    compare ycurr, ymax
+<span id="L253" class="LineNr">253 </span>    <span class="Delimiter">{</span>
+<span id="L254" class="LineNr">254 </span>      <span class="PreProc">break-if-&lt;</span>
+<span id="L255" class="LineNr">255 </span>      xcurr <span class="SpecialChar">&lt;-</span> add <span class="Constant">8</span>  <span class="muComment"># font-width</span>
+<span id="L256" class="LineNr">256 </span>      ycurr <span class="SpecialChar">&lt;-</span> copy ymin
+<span id="L257" class="LineNr">257 </span>    <span class="Delimiter">}</span>
+<span id="L258" class="LineNr">258 </span>    <span class="PreProc">loop</span>
+<span id="L259" class="LineNr">259 </span>  <span class="Delimiter">}</span>
+<span id="L260" class="LineNr">260 </span>  compare xcurr, xmax
+<span id="L261" class="LineNr">261 </span>  <span class="Delimiter">{</span>
+<span id="L262" class="LineNr">262 </span>    <span class="PreProc">break-if-&lt;</span>
+<span id="L263" class="LineNr">263 </span>    <span class="PreProc">return</span> <span class="Constant">0</span>, <span class="Constant">0</span>
 <span id="L264" class="LineNr">264 </span>  <span class="Delimiter">}</span>
-<span id="L265" class="LineNr">265 </span>  compare xcurr, xmax
-<span id="L266" class="LineNr">266 </span>  <span class="Delimiter">{</span>
-<span id="L267" class="LineNr">267 </span>    <span class="PreProc">break-if-&lt;</span>
-<span id="L268" class="LineNr">268 </span>    <span class="PreProc">return</span> <span class="Constant">0</span>, <span class="Constant">0</span>
-<span id="L269" class="LineNr">269 </span>  <span class="Delimiter">}</span>
-<span id="L270" class="LineNr">270 </span>  <span class="muComment"># we do; actually draw</span>
-<span id="L271" class="LineNr">271 </span>  <a href='106stream.subx.html#L56'>rewind-stream</a> stream
-<span id="L272" class="LineNr">272 </span>  xcurr <span class="SpecialChar">&lt;-</span> copy x
-<span id="L273" class="LineNr">273 </span>  ycurr <span class="SpecialChar">&lt;-</span> copy y
-<span id="L274" class="LineNr">274 </span>  <span class="Delimiter">{</span>
-<span id="L275" class="LineNr">275 </span>    <span class="PreProc">var</span> g/<span class="Constant">eax</span>: grapheme <span class="SpecialChar">&lt;-</span> <a href='403unicode.mu.html#L92'>read-grapheme</a> stream
-<span id="L276" class="LineNr">276 </span>    compare g, <span class="Constant">0xffffffff</span>  <span class="muComment"># end-of-file</span>
-<span id="L277" class="LineNr">277 </span>    <span class="PreProc">break-if-=</span>
-<span id="L278" class="LineNr">278 </span>    <a href='103grapheme.subx.html#L1'>draw-grapheme</a> screen, g, xcurr, ycurr, color
-<span id="L279" class="LineNr">279 </span>    ycurr <span class="SpecialChar">&lt;-</span> add <span class="Constant">0x10</span>  <span class="muComment"># font-height</span>
-<span id="L280" class="LineNr">280 </span>    compare ycurr, ymax
-<span id="L281" class="LineNr">281 </span>    <span class="Delimiter">{</span>
-<span id="L282" class="LineNr">282 </span>      <span class="PreProc">break-if-&lt;</span>
-<span id="L283" class="LineNr">283 </span>      xcurr <span class="SpecialChar">&lt;-</span> add <span class="Constant">8</span>  <span class="muComment"># font-width</span>
-<span id="L284" class="LineNr">284 </span>      ycurr <span class="SpecialChar">&lt;-</span> copy ymin
-<span id="L285" class="LineNr">285 </span>    <span class="Delimiter">}</span>
-<span id="L286" class="LineNr">286 </span>    <span class="PreProc">loop</span>
-<span id="L287" class="LineNr">287 </span>  <span class="Delimiter">}</span>
-<span id="L288" class="LineNr">288 </span>  <a href='103grapheme.subx.html#L86'>set-cursor-position</a> screen, xcurr, ycurr
-<span id="L289" class="LineNr">289 </span>  <span class="PreProc">return</span> xcurr, ycurr
-<span id="L290" class="LineNr">290 </span><span class="Delimiter">}</span>
-<span id="L291" class="LineNr">291 </span>
-<span id="L292" class="LineNr">292 </span><span class="PreProc">fn</span> <span class="muFunction"><a href='501draw-text.mu.html#L292'>draw-text-wrapping-down-then-right-over-full-screen</a></span> screen: (addr screen), text: (addr array byte), x: int, y: int, color: int<span class="PreProc"> -&gt; </span>_/<span class="Constant">eax</span>: int, _/<span class="Constant">ecx</span>: int <span class="Delimiter">{</span>
-<span id="L293" class="LineNr">293 </span>  <span class="PreProc">var</span> cursor-x/<span class="Constant">eax</span>: int <span class="SpecialChar">&lt;-</span> copy <span class="Constant">0</span>
-<span id="L294" class="LineNr">294 </span>  <span class="PreProc">var</span> cursor-y/<span class="Constant">ecx</span>: int <span class="SpecialChar">&lt;-</span> copy <span class="Constant">0</span>
-<span id="L295" class="LineNr">295 </span>  cursor-x, cursor-y <span class="SpecialChar">&lt;-</span> <a href='501draw-text.mu.html#L243'>draw-text-wrapping-down-then-right</a> screen, text, <span class="Constant">0</span>, <span class="Constant">0</span>, <span class="Constant">0x400</span>, <span class="Constant">0x300</span>, x, y, color  <span class="muComment"># 1024, 768</span>
-<span id="L296" class="LineNr">296 </span>  <span class="PreProc">return</span> cursor-x, cursor-y
-<span id="L297" class="LineNr">297 </span><span class="Delimiter">}</span>
-<span id="L298" class="LineNr">298 </span>
-<span id="L299" class="LineNr">299 </span><span class="PreProc">fn</span> <span class="muFunction"><a href='501draw-text.mu.html#L299'>draw-text-wrapping-down-then-right-from-cursor</a></span> screen: (addr screen), text: (addr array byte), xmin: int, ymin: int, xmax: int, ymax: int, color: int<span class="PreProc"> -&gt; </span>_/<span class="Constant">eax</span>: int, _/<span class="Constant">ecx</span>: int <span class="Delimiter">{</span>
-<span id="L300" class="LineNr">300 </span>  <span class="PreProc">var</span> cursor-x/<span class="Constant">eax</span>: int <span class="SpecialChar">&lt;-</span> copy <span class="Constant">0</span>
-<span id="L301" class="LineNr">301 </span>  <span class="PreProc">var</span> cursor-y/<span class="Constant">ecx</span>: int <span class="SpecialChar">&lt;-</span> copy <span class="Constant">0</span>
-<span id="L302" class="LineNr">302 </span>  cursor-x, cursor-y <span class="SpecialChar">&lt;-</span> <a href='103grapheme.subx.html#L73'>cursor-position</a> screen
-<span id="L303" class="LineNr">303 </span>  <span class="PreProc">var</span> end-y/<span class="Constant">edx</span>: int <span class="SpecialChar">&lt;-</span> copy cursor-y
-<span id="L304" class="LineNr">304 </span>  end-y <span class="SpecialChar">&lt;-</span> add <span class="Constant">0x10</span>  <span class="muComment"># font-height</span>
-<span id="L305" class="LineNr">305 </span>  compare end-y, ymax
-<span id="L306" class="LineNr">306 </span>  <span class="Delimiter">{</span>
-<span id="L307" class="LineNr">307 </span>    <span class="PreProc">break-if-&lt;</span>
-<span id="L308" class="LineNr">308 </span>    cursor-x <span class="SpecialChar">&lt;-</span> add <span class="Constant">8</span>  <span class="muComment"># font-width</span>
-<span id="L309" class="LineNr">309 </span>    cursor-y <span class="SpecialChar">&lt;-</span> copy ymin
-<span id="L310" class="LineNr">310 </span>  <span class="Delimiter">}</span>
-<span id="L311" class="LineNr">311 </span>  cursor-x, cursor-y <span class="SpecialChar">&lt;-</span> <a href='501draw-text.mu.html#L243'>draw-text-wrapping-down-then-right</a> screen, text, xmin, ymin, xmax, ymax, cursor-x, cursor-y, color
-<span id="L312" class="LineNr">312 </span>  <span class="PreProc">return</span> cursor-x, cursor-y
-<span id="L313" class="LineNr">313 </span><span class="Delimiter">}</span>
-<span id="L314" class="LineNr">314 </span>
-<span id="L315" class="LineNr">315 </span><span class="PreProc">fn</span> <span class="muFunction"><a href='501draw-text.mu.html#L315'>draw-text-wrapping-down-then-right-from-cursor-over-full-screen</a></span> screen: (addr screen), text: (addr array byte), color: int<span class="PreProc"> -&gt; </span>_/<span class="Constant">eax</span>: int, _/<span class="Constant">ecx</span>: int <span class="Delimiter">{</span>
-<span id="L316" class="LineNr">316 </span>  <span class="PreProc">var</span> cursor-x/<span class="Constant">eax</span>: int <span class="SpecialChar">&lt;-</span> copy <span class="Constant">0</span>
-<span id="L317" class="LineNr">317 </span>  <span class="PreProc">var</span> cursor-y/<span class="Constant">ecx</span>: int <span class="SpecialChar">&lt;-</span> copy <span class="Constant">0</span>
-<span id="L318" class="LineNr">318 </span>  cursor-x, cursor-y <span class="SpecialChar">&lt;-</span> <a href='501draw-text.mu.html#L299'>draw-text-wrapping-down-then-right-from-cursor</a> screen, text, <span class="Constant">0</span>, <span class="Constant">0</span>, <span class="Constant">0x400</span>, <span class="Constant">0x300</span>, color  <span class="muComment"># 1024, 768</span>
-<span id="L319" class="LineNr">319 </span>  <span class="PreProc">return</span> cursor-x, cursor-y
-<span id="L320" class="LineNr">320 </span><span class="Delimiter">}</span>
+<span id="L265" class="LineNr">265 </span>  <span class="muComment"># we do; actually draw</span>
+<span id="L266" class="LineNr">266 </span>  <a href='106stream.subx.html#L56'>rewind-stream</a> stream
+<span id="L267" class="LineNr">267 </span>  xcurr <span class="SpecialChar">&lt;-</span> copy x
+<span id="L268" class="LineNr">268 </span>  ycurr <span class="SpecialChar">&lt;-</span> copy y
+<span id="L269" class="LineNr">269 </span>  <span class="Delimiter">{</span>
+<span id="L270" class="LineNr">270 </span>    <span class="PreProc">var</span> g/<span class="Constant">eax</span>: grapheme <span class="SpecialChar">&lt;-</span> <a href='403unicode.mu.html#L92'>read-grapheme</a> stream
+<span id="L271" class="LineNr">271 </span>    compare g, <span class="Constant">0xffffffff</span>  <span class="muComment"># end-of-file</span>
+<span id="L272" class="LineNr">272 </span>    <span class="PreProc">break-if-=</span>
+<span id="L273" class="LineNr">273 </span>    <a href='103grapheme.subx.html#L5'>draw-grapheme</a> screen, g, xcurr, ycurr, color
+<span id="L274" class="LineNr">274 </span>    ycurr <span class="SpecialChar">&lt;-</span> add <span class="Constant">0x10</span>  <span class="muComment"># font-height</span>
+<span id="L275" class="LineNr">275 </span>    compare ycurr, ymax
+<span id="L276" class="LineNr">276 </span>    <span class="Delimiter">{</span>
+<span id="L277" class="LineNr">277 </span>      <span class="PreProc">break-if-&lt;</span>
+<span id="L278" class="LineNr">278 </span>      xcurr <span class="SpecialChar">&lt;-</span> add <span class="Constant">8</span>  <span class="muComment"># font-width</span>
+<span id="L279" class="LineNr">279 </span>      ycurr <span class="SpecialChar">&lt;-</span> copy ymin
+<span id="L280" class="LineNr">280 </span>    <span class="Delimiter">}</span>
+<span id="L281" class="LineNr">281 </span>    <span class="PreProc">loop</span>
+<span id="L282" class="LineNr">282 </span>  <span class="Delimiter">}</span>
+<span id="L283" class="LineNr">283 </span>  <a href='103grapheme.subx.html#L90'>set-cursor-position</a> screen, xcurr, ycurr
+<span id="L284" class="LineNr">284 </span>  <span class="PreProc">return</span> xcurr, ycurr
+<span id="L285" class="LineNr">285 </span><span class="Delimiter">}</span>
+<span id="L286" class="LineNr">286 </span>
+<span id="L287" class="LineNr">287 </span><span class="PreProc">fn</span> <span class="muFunction"><a href='501draw-text.mu.html#L287'>draw-text-wrapping-down-then-right-over-full-screen</a></span> screen: (addr screen), text: (addr array byte), x: int, y: int, color: int<span class="PreProc"> -&gt; </span>_/<span class="Constant">eax</span>: int, _/<span class="Constant">ecx</span>: int <span class="Delimiter">{</span>
+<span id="L288" class="LineNr">288 </span>  <span class="PreProc">var</span> cursor-x/<span class="Constant">eax</span>: int <span class="SpecialChar">&lt;-</span> copy <span class="Constant">0</span>
+<span id="L289" class="LineNr">289 </span>  <span class="PreProc">var</span> cursor-y/<span class="Constant">ecx</span>: int <span class="SpecialChar">&lt;-</span> copy <span class="Constant">0</span>
+<span id="L290" class="LineNr">290 </span>  cursor-x, cursor-y <span class="SpecialChar">&lt;-</span> <a href='501draw-text.mu.html#L238'>draw-text-wrapping-down-then-right</a> screen, text, <span class="Constant">0</span>, <span class="Constant">0</span>, <span class="Constant">0x400</span>, <span class="Constant">0x300</span>, x, y, color  <span class="muComment"># 1024, 768</span>
+<span id="L291" class="LineNr">291 </span>  <span class="PreProc">return</span> cursor-x, cursor-y
+<span id="L292" class="LineNr">292 </span><span class="Delimiter">}</span>
+<span id="L293" class="LineNr">293 </span>
+<span id="L294" class="LineNr">294 </span><span class="PreProc">fn</span> <span class="muFunction"><a href='501draw-text.mu.html#L294'>draw-text-wrapping-down-then-right-from-cursor</a></span> screen: (addr screen), text: (addr array byte), xmin: int, ymin: int, xmax: int, ymax: int, color: int <span class="Delimiter">{</span>
+<span id="L295" class="LineNr">295 </span>  <span class="PreProc">var</span> cursor-x/<span class="Constant">eax</span>: int <span class="SpecialChar">&lt;-</span> copy <span class="Constant">0</span>
+<span id="L296" class="LineNr">296 </span>  <span class="PreProc">var</span> cursor-y/<span class="Constant">ecx</span>: int <span class="SpecialChar">&lt;-</span> copy <span class="Constant">0</span>
+<span id="L297" class="LineNr">297 </span>  cursor-x, cursor-y <span class="SpecialChar">&lt;-</span> <a href='103grapheme.subx.html#L77'>cursor-position</a> screen
+<span id="L298" class="LineNr">298 </span>  <span class="PreProc">var</span> end-y/<span class="Constant">edx</span>: int <span class="SpecialChar">&lt;-</span> copy cursor-y
+<span id="L299" class="LineNr">299 </span>  end-y <span class="SpecialChar">&lt;-</span> add <span class="Constant">0x10</span>  <span class="muComment"># font-height</span>
+<span id="L300" class="LineNr">300 </span>  compare end-y, ymax
+<span id="L301" class="LineNr">301 </span>  <span class="Delimiter">{</span>
+<span id="L302" class="LineNr">302 </span>    <span class="PreProc">break-if-&lt;</span>
+<span id="L303" class="LineNr">303 </span>    cursor-x <span class="SpecialChar">&lt;-</span> add <span class="Constant">8</span>  <span class="muComment"># font-width</span>
+<span id="L304" class="LineNr">304 </span>    cursor-y <span class="SpecialChar">&lt;-</span> copy ymin
+<span id="L305" class="LineNr">305 </span>  <span class="Delimiter">}</span>
+<span id="L306" class="LineNr">306 </span>  cursor-x, cursor-y <span class="SpecialChar">&lt;-</span> <a href='501draw-text.mu.html#L238'>draw-text-wrapping-down-then-right</a> screen, text, xmin, ymin, xmax, ymax, cursor-x, cursor-y, color
+<span id="L307" class="LineNr">307 </span><span class="Delimiter">}</span>
+<span id="L308" class="LineNr">308 </span>
+<span id="L309" class="LineNr">309 </span><span class="PreProc">fn</span> <span class="muFunction"><a href='501draw-text.mu.html#L309'>draw-text-wrapping-down-then-right-from-cursor-over-full-screen</a></span> screen: (addr screen), text: (addr array byte), color: int <span class="Delimiter">{</span>
+<span id="L310" class="LineNr">310 </span>  <a href='501draw-text.mu.html#L294'>draw-text-wrapping-down-then-right-from-cursor</a> screen, text, <span class="Constant">0</span>, <span class="Constant">0</span>, <span class="Constant">0x400</span>, <span class="Constant">0x300</span>, color  <span class="muComment"># 1024, 768</span>
+<span id="L311" class="LineNr">311 </span><span class="Delimiter">}</span>
 </pre>
 </body>
 </html>
diff --git a/html/baremetal/502test.mu.html b/html/baremetal/502test.mu.html
new file mode 100644
index 00000000..f1bf0f28
--- /dev/null
+++ b/html/baremetal/502test.mu.html
@@ -0,0 +1,82 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
+<html>
+<head>
+<meta http-equiv="content-type" content="text/html; charset=UTF-8">
+<title>Mu - baremetal/502test.mu</title>
+<meta name="Generator" content="Vim/8.1">
+<meta name="plugin-version" content="vim8.1_v1">
+<meta name="syntax" content="none">
+<meta name="settings" content="number_lines,use_css,pre_wrap,no_foldcolumn,expand_tabs,line_ids,prevent_copy=">
+<meta name="colorscheme" content="minimal-light">
+<style type="text/css">
+<!--
+pre { white-space: pre-wrap; font-family: monospace; color: #000000; background-color: #c6c6c6; }
+body { font-size:12pt; font-family: monospace; color: #000000; background-color: #c6c6c6; }
+a { color:inherit; }
+* { font-size:12pt; font-size: 1em; }
+.PreProc { color: #c000c0; }
+.LineNr { }
+.Constant { color: #008787; }
+.SpecialChar { color: #d70000; }
+.Delimiter { color: #c000c0; }
+.muFunction { color: #af5f00; text-decoration: underline; }
+.muTest { color: #5f8700; }
+.muComment { color: #005faf; }
+-->
+</style>
+
+<script type='text/javascript'>
+<!--
+
+/* function to open any folds containing a jumped-to line before jumping to it */
+function JumpToLine()
+{
+  var lineNum;
+  lineNum = window.location.hash;
+  lineNum = lineNum.substr(1); /* strip off '#' */
+
+  if (lineNum.indexOf('L') == -1) {
+    lineNum = 'L'+lineNum;
+  }
+  var lineElem = document.getElementById(lineNum);
+  /* Always jump to new location even if the line was hidden inside a fold, or
+   * we corrected the raw number to a line ID.
+   */
+  if (lineElem) {
+    lineElem.scrollIntoView(true);
+  }
+  return true;
+}
+if ('onhashchange' in window) {
+  window.onhashchange = JumpToLine;
+}
+
+-->
+</script>
+</head>
+<body onload='JumpToLine();'>
+<a href='https://github.com/akkartik/mu/blob/main/baremetal/502test.mu'>https://github.com/akkartik/mu/blob/main/baremetal/502test.mu</a>
+<pre id='vimCodeElement'>
+<span id="L1" class="LineNr"> 1 </span><span class="muComment"># print msg to screen if a != b, otherwise print &quot;.&quot;</span>
+<span id="L2" class="LineNr"> 2 </span><span class="PreProc">fn</span> <span class="muFunction"><a href='502test.mu.html#L2'>check-ints-equal</a></span> _a: int, b: int, msg: (addr array byte) <span class="Delimiter">{</span>
+<span id="L3" class="LineNr"> 3 </span>  <span class="PreProc">var</span> a/<span class="Constant">eax</span>: int <span class="SpecialChar">&lt;-</span> copy _a
+<span id="L4" class="LineNr"> 4 </span>  compare a, b
+<span id="L5" class="LineNr"> 5 </span>  <span class="Delimiter">{</span>
+<span id="L6" class="LineNr"> 6 </span>    <span class="PreProc">break-if-=</span>
+<span id="L7" class="LineNr"> 7 </span>    <a href='501draw-text.mu.html#L183'>draw-text-wrapping-right-then-down-from-cursor-over-full-screen</a> <span class="Constant">0</span>, msg, <span class="Constant">3</span>  <span class="muComment"># 3=cyan</span>
+<span id="L8" class="LineNr"> 8 </span>    <a href='104test.subx.html#L5'>count-test-failure</a>
+<span id="L9" class="LineNr"> 9 </span>    <span class="PreProc">return</span>
+<span id="L10" class="LineNr">10 </span>  <span class="Delimiter">}</span>
+<span id="L11" class="LineNr">11 </span>  <span class="Delimiter">{</span>
+<span id="L12" class="LineNr">12 </span>    <span class="PreProc">break-if-!=</span>
+<span id="L13" class="LineNr">13 </span>    <a href='501draw-text.mu.html#L183'>draw-text-wrapping-right-then-down-from-cursor-over-full-screen</a> <span class="Constant">0</span>, <span class="Constant">&quot;.&quot;</span>, <span class="Constant">3</span>  <span class="muComment"># 3=cyan</span>
+<span id="L14" class="LineNr">14 </span>  <span class="Delimiter">}</span>
+<span id="L15" class="LineNr">15 </span><span class="Delimiter">}</span>
+<span id="L16" class="LineNr">16 </span>
+<span id="L17" class="LineNr">17 </span><span class="PreProc">fn</span> <span class="muTest"><a href='502test.mu.html#L17'>test-check-ints-equal</a></span> <span class="Delimiter">{</span>
+<span id="L18" class="LineNr">18 </span>  <a href='502test.mu.html#L2'>check-ints-equal</a> <span class="Constant">0</span>, <span class="Constant">0</span>, <span class="Constant">&quot;abc&quot;</span>
+<span id="L19" class="LineNr">19 </span><span class="Delimiter">}</span>
+</pre>
+</body>
+</html>
+<!-- vim: set foldmethod=manual : -->
diff --git a/html/baremetal/503manhattan-line.mu.html b/html/baremetal/503manhattan-line.mu.html
index bb47dd36..916b6f67 100644
--- a/html/baremetal/503manhattan-line.mu.html
+++ b/html/baremetal/503manhattan-line.mu.html
@@ -67,7 +67,7 @@ if ('onhashchange' in window) {
 <span id="L10" class="LineNr">10 </span>  <span class="Delimiter">{</span>
 <span id="L11" class="LineNr">11 </span>    compare x, x2
 <span id="L12" class="LineNr">12 </span>    <span class="PreProc">break-if-&gt;=</span>
-<span id="L13" class="LineNr">13 </span>    <a href='101screen.subx.html#L3'>pixel</a> screen, x, y, color
+<span id="L13" class="LineNr">13 </span>    <a href='101screen.subx.html#L5'>pixel</a> screen, x, y, color
 <span id="L14" class="LineNr">14 </span>    x <span class="SpecialChar">&lt;-</span> increment
 <span id="L15" class="LineNr">15 </span>    <span class="PreProc">loop</span>
 <span id="L16" class="LineNr">16 </span>  <span class="Delimiter">}</span>
@@ -78,7 +78,7 @@ if ('onhashchange' in window) {
 <span id="L21" class="LineNr">21 </span>  <span class="Delimiter">{</span>
 <span id="L22" class="LineNr">22 </span>    compare y, y2
 <span id="L23" class="LineNr">23 </span>    <span class="PreProc">break-if-&gt;=</span>
-<span id="L24" class="LineNr">24 </span>    <a href='101screen.subx.html#L3'>pixel</a> screen, x, y, color
+<span id="L24" class="LineNr">24 </span>    <a href='101screen.subx.html#L5'>pixel</a> screen, x, y, color
 <span id="L25" class="LineNr">25 </span>    y <span class="SpecialChar">&lt;-</span> increment
 <span id="L26" class="LineNr">26 </span>    <span class="PreProc">loop</span>
 <span id="L27" class="LineNr">27 </span>  <span class="Delimiter">}</span>
diff --git a/html/baremetal/ex1.subx.html b/html/baremetal/ex1.subx.html
index dca74155..124ce287 100644
--- a/html/baremetal/ex1.subx.html
+++ b/html/baremetal/ex1.subx.html
@@ -64,10 +64,12 @@ if ('onhashchange' in window) {
 <span id="L10" class="LineNr">10 </span><span class="subxComment"># Or:</span>
 <span id="L11" class="LineNr">11 </span><span class="subxComment">#   bochs -f baremetal/boot.bochsrc  # boot.bochsrc loads disk.img</span>
 <span id="L12" class="LineNr">12 </span>
-<span id="L13" class="LineNr">13 </span><span class="subxFunction">main</span>:
-<span id="L14" class="LineNr">14 </span>  e9/jump <a href='ex1.subx.html#L13'>main</a>/disp32
-<span id="L15" class="LineNr">15 </span>
-<span id="L16" class="LineNr">16 </span><span class="subxComment"># vim&#0058;ft=subx</span>
+<span id="L13" class="LineNr">13 </span>== code
+<span id="L14" class="LineNr">14 </span>
+<span id="L15" class="LineNr">15 </span><span class="subxFunction">main</span>:
+<span id="L16" class="LineNr">16 </span>  e9/jump <a href='ex1.subx.html#L15'>main</a>/disp32
+<span id="L17" class="LineNr">17 </span>
+<span id="L18" class="LineNr">18 </span><span class="subxComment"># vim&#0058;ft=subx</span>
 </pre>
 </body>
 </html>
diff --git a/html/baremetal/ex2.mu.html b/html/baremetal/ex2.mu.html
index a0f4508d..dc700ce5 100644
--- a/html/baremetal/ex2.mu.html
+++ b/html/baremetal/ex2.mu.html
@@ -79,7 +79,7 @@ if ('onhashchange' in window) {
 <span id="L21" class="LineNr">21 </span>      <span class="PreProc">break-if-&gt;=</span>
 <span id="L22" class="LineNr">22 </span>      <span class="PreProc">var</span> color/<span class="Constant">ecx</span>: int <span class="SpecialChar">&lt;-</span> copy x
 <span id="L23" class="LineNr">23 </span>      color <span class="SpecialChar">&lt;-</span> and <span class="Constant">0xff</span>
-<span id="L24" class="LineNr">24 </span>      <a href='101screen.subx.html#L3'>pixel</a> <span class="Constant">0</span>, x, y, color
+<span id="L24" class="LineNr">24 </span>      <a href='101screen.subx.html#L5'>pixel</a> <span class="Constant">0</span>, x, y, color
 <span id="L25" class="LineNr">25 </span>      x <span class="SpecialChar">&lt;-</span> increment
 <span id="L26" class="LineNr">26 </span>      <span class="PreProc">loop</span>
 <span id="L27" class="LineNr">27 </span>    <span class="Delimiter">}</span>
diff --git a/html/baremetal/ex2.subx.html b/html/baremetal/ex2.subx.html
index 3d27392c..9064d31b 100644
--- a/html/baremetal/ex2.subx.html
+++ b/html/baremetal/ex2.subx.html
@@ -65,27 +65,29 @@ if ('onhashchange' in window) {
 <span id="L10" class="LineNr">10 </span><span class="subxComment"># Expected output:</span>
 <span id="L11" class="LineNr">11 </span><span class="subxComment">#   html/baremetal.png</span>
 <span id="L12" class="LineNr">12 </span>
-<span id="L13" class="LineNr">13 </span><span class="subxFunction">main</span>:
-<span id="L14" class="LineNr">14 </span>  <span class="subxComment"># ecx &lt;- start of video memory</span>
-<span id="L15" class="LineNr">15 </span>  8b/-&gt; *0x7f28 1/r32/ecx
-<span id="L16" class="LineNr">16 </span>
-<span id="L17" class="LineNr">17 </span>  <span class="subxComment"># eax &lt;- final pixel of video memory</span>
-<span id="L18" class="LineNr">18 </span>  8d/copy-address *(ecx + 0x0bffff) 0/r32/eax  <span class="subxComment"># 0xbffff = 1024*768 - 1</span>
-<span id="L19" class="LineNr">19 </span>
-<span id="L20" class="LineNr">20 </span>  <span class="subxComment"># for each pixel in video memory</span>
-<span id="L21" class="LineNr">21 </span>  {
-<span id="L22" class="LineNr">22 </span>    39/compare %eax 1/r32/ecx
-<span id="L23" class="LineNr">23 </span>    7c/jump-if-&lt; <span class="Constant">break</span>/disp8
-<span id="L24" class="LineNr">24 </span>    <span class="subxComment"># write its column number to it</span>
-<span id="L25" class="LineNr">25 </span>    88/byte&lt;- *eax 0/r32/AL
-<span id="L26" class="LineNr">26 </span>    48/decrement-eax
-<span id="L27" class="LineNr">27 </span>    eb/jump <span class="Constant">loop</span>/disp8
-<span id="L28" class="LineNr">28 </span>  }
-<span id="L29" class="LineNr">29 </span>
-<span id="L30" class="LineNr">30 </span>  <span class="subxComment"># hang indefinitely</span>
-<span id="L31" class="LineNr">31 </span>  {
-<span id="L32" class="LineNr">32 </span>    eb/jump <span class="Constant">loop</span>/disp8
-<span id="L33" class="LineNr">33 </span>  }
+<span id="L13" class="LineNr">13 </span>== code
+<span id="L14" class="LineNr">14 </span>
+<span id="L15" class="LineNr">15 </span><span class="subxFunction">main</span>:
+<span id="L16" class="LineNr">16 </span>  <span class="subxComment"># ecx &lt;- start of video memory</span>
+<span id="L17" class="LineNr">17 </span>  8b/-&gt; *0x7f28 1/r32/ecx
+<span id="L18" class="LineNr">18 </span>
+<span id="L19" class="LineNr">19 </span>  <span class="subxComment"># eax &lt;- final pixel of video memory</span>
+<span id="L20" class="LineNr">20 </span>  8d/copy-address *(ecx + 0x0bffff) 0/r32/eax  <span class="subxComment"># 0xbffff = 1024*768 - 1</span>
+<span id="L21" class="LineNr">21 </span>
+<span id="L22" class="LineNr">22 </span>  <span class="subxComment"># for each pixel in video memory</span>
+<span id="L23" class="LineNr">23 </span>  {
+<span id="L24" class="LineNr">24 </span>    39/compare %eax 1/r32/ecx
+<span id="L25" class="LineNr">25 </span>    7c/jump-if-&lt; <span class="Constant">break</span>/disp8
+<span id="L26" class="LineNr">26 </span>    <span class="subxComment"># write its column number to it</span>
+<span id="L27" class="LineNr">27 </span>    88/byte&lt;- *eax 0/r32/AL
+<span id="L28" class="LineNr">28 </span>    48/decrement-eax
+<span id="L29" class="LineNr">29 </span>    eb/jump <span class="Constant">loop</span>/disp8
+<span id="L30" class="LineNr">30 </span>  }
+<span id="L31" class="LineNr">31 </span>
+<span id="L32" class="LineNr">32 </span>  <span class="subxComment"># hang indefinitely</span>
+<span id="L33" class="LineNr">33 </span>  {
+<span id="L34" class="LineNr">34 </span>    eb/jump <span class="Constant">loop</span>/disp8
+<span id="L35" class="LineNr">35 </span>  }
 </pre>
 </body>
 </html>
diff --git a/html/baremetal/ex3.mu.html b/html/baremetal/ex3.mu.html
index 7d79c8c5..288b015a 100644
--- a/html/baremetal/ex3.mu.html
+++ b/html/baremetal/ex3.mu.html
@@ -73,10 +73,10 @@ if ('onhashchange' in window) {
 <span id="L15" class="LineNr">15 </span>  <span class="PreProc">var</span> x/<span class="Constant">ecx</span>: int <span class="SpecialChar">&lt;-</span> copy <span class="Constant">0</span>
 <span id="L16" class="LineNr">16 </span>  <span class="PreProc">var</span> y/<span class="Constant">edx</span>: int <span class="SpecialChar">&lt;-</span> copy <span class="Constant">0</span>
 <span id="L17" class="LineNr">17 </span>  <span class="Delimiter">{</span>
-<span id="L18" class="LineNr">18 </span>    <span class="PreProc">var</span> key/<span class="Constant">eax</span>: byte <span class="SpecialChar">&lt;-</span> <a href='102keyboard.subx.html#L3'>read-key</a> <span class="Constant">0</span>  <span class="muComment"># real keyboard</span>
+<span id="L18" class="LineNr">18 </span>    <span class="PreProc">var</span> key/<span class="Constant">eax</span>: byte <span class="SpecialChar">&lt;-</span> <a href='102keyboard.subx.html#L6'>read-key</a> <span class="Constant">0</span>  <span class="muComment"># real keyboard</span>
 <span id="L19" class="LineNr">19 </span>    compare key, <span class="Constant">0</span>
 <span id="L20" class="LineNr">20 </span>    <span class="PreProc">loop-if-=</span>  <span class="muComment"># busy wait</span>
-<span id="L21" class="LineNr">21 </span>    <a href='101screen.subx.html#L3'>pixel</a> <span class="Constant">0</span>, x, y, <span class="Constant">0x31</span>  <span class="muComment"># green</span>
+<span id="L21" class="LineNr">21 </span>    <a href='101screen.subx.html#L5'>pixel</a> <span class="Constant">0</span>, x, y, <span class="Constant">0x31</span>  <span class="muComment"># green</span>
 <span id="L22" class="LineNr">22 </span>    x <span class="SpecialChar">&lt;-</span> increment
 <span id="L23" class="LineNr">23 </span>    compare x, <span class="Constant">0x400</span>
 <span id="L24" class="LineNr">24 </span>    <span class="Delimiter">{</span>
diff --git a/html/baremetal/ex4.mu.html b/html/baremetal/ex4.mu.html
index 30d0063d..c74e8633 100644
--- a/html/baremetal/ex4.mu.html
+++ b/html/baremetal/ex4.mu.html
@@ -69,7 +69,7 @@ if ('onhashchange' in window) {
 <span id="L11" class="LineNr">11 </span>
 <span id="L12" class="LineNr">12 </span><span class="PreProc">fn</span> <span class="muFunction"><a href='ex4.mu.html#L12'>main</a></span> <span class="Delimiter">{</span>
 <span id="L13" class="LineNr">13 </span>  <span class="PreProc">var</span> g/<span class="Constant">eax</span>: grapheme <span class="SpecialChar">&lt;-</span> copy <span class="Constant">0x41</span>  <span class="muComment"># 'A'</span>
-<span id="L14" class="LineNr">14 </span>  <a href='103grapheme.subx.html#L1'>draw-grapheme</a> <span class="Constant">0</span>, g, <span class="Constant">0x10</span>, <span class="Constant">0x10</span>, <span class="Constant">0xa</span>
+<span id="L14" class="LineNr">14 </span>  <a href='103grapheme.subx.html#L5'>draw-grapheme</a> <span class="Constant">0</span>, g, <span class="Constant">0x10</span>, <span class="Constant">0x10</span>, <span class="Constant">0xa</span>
 <span id="L15" class="LineNr">15 </span><span class="Delimiter">}</span>
 </pre>
 </body>
diff --git a/html/baremetal/ex6.mu.html b/html/baremetal/ex6.mu.html
index 5121d218..01fd7ee4 100644
--- a/html/baremetal/ex6.mu.html
+++ b/html/baremetal/ex6.mu.html
@@ -78,15 +78,15 @@ if ('onhashchange' in window) {
 <span id="L20" class="LineNr">20 </span>  x, y <span class="SpecialChar">&lt;-</span> <a href='501draw-text.mu.html#L112'>draw-text-wrapping-right-then-down</a> <span class="Constant">0</span>, <span class="Constant">&quot;Mu!&quot;</span>,        <span class="Constant">0x10</span>, <span class="Constant">0x20</span>, <span class="Constant">0x78</span>, <span class="Constant">0x50</span>, x, y, <span class="Constant">0xa</span>
 <span id="L21" class="LineNr">21 </span>
 <span id="L22" class="LineNr">22 </span>  <span class="muComment"># drawing at the cursor in multiple directions</span>
-<span id="L23" class="LineNr">23 </span>  x, y <span class="SpecialChar">&lt;-</span> <a href='501draw-text.mu.html#L315'>draw-text-wrapping-down-then-right-from-cursor-over-full-screen</a> <span class="Constant">0</span>, <span class="Constant">&quot;abc&quot;</span>, <span class="Constant">0xa</span>
-<span id="L24" class="LineNr">24 </span>  x, y <span class="SpecialChar">&lt;-</span> <a href='501draw-text.mu.html#L184'>draw-text-wrapping-right-then-down-from-cursor-over-full-screen</a> <span class="Constant">0</span>, <span class="Constant">&quot;def&quot;</span>, <span class="Constant">0xa</span>
+<span id="L23" class="LineNr">23 </span>  <a href='501draw-text.mu.html#L309'>draw-text-wrapping-down-then-right-from-cursor-over-full-screen</a> <span class="Constant">0</span>, <span class="Constant">&quot;abc&quot;</span>, <span class="Constant">0xa</span>
+<span id="L24" class="LineNr">24 </span>  <a href='501draw-text.mu.html#L183'>draw-text-wrapping-right-then-down-from-cursor-over-full-screen</a> <span class="Constant">0</span>, <span class="Constant">&quot;def&quot;</span>, <span class="Constant">0xa</span>
 <span id="L25" class="LineNr">25 </span>
 <span id="L26" class="LineNr">26 </span>  <span class="muComment"># test drawing near the edge</span>
 <span id="L27" class="LineNr">27 </span>  x <span class="SpecialChar">&lt;-</span> <a href='501draw-text.mu.html#L65'>draw-text-rightward</a> <span class="Constant">0</span>, <span class="Constant">&quot;R&quot;</span>, <span class="Constant">0x3f8</span>, <span class="Constant">0x400</span>, <span class="Constant">0x100</span>, <span class="Constant">0xa</span>
-<span id="L28" class="LineNr">28 </span>  x, y <span class="SpecialChar">&lt;-</span> <a href='501draw-text.mu.html#L184'>draw-text-wrapping-right-then-down-from-cursor-over-full-screen</a> <span class="Constant">0</span>, <span class="Constant">&quot;wrapped from R&quot;</span>, <span class="Constant">0xa</span>
+<span id="L28" class="LineNr">28 </span>  <a href='501draw-text.mu.html#L183'>draw-text-wrapping-right-then-down-from-cursor-over-full-screen</a> <span class="Constant">0</span>, <span class="Constant">&quot;wrapped from R&quot;</span>, <span class="Constant">0xa</span>
 <span id="L29" class="LineNr">29 </span>
-<span id="L30" class="LineNr">30 </span>  x <span class="SpecialChar">&lt;-</span> <a href='501draw-text.mu.html#L196'>draw-text-downward</a> <span class="Constant">0</span>, <span class="Constant">&quot;D&quot;</span>, <span class="Constant">0x100</span>, <span class="Constant">0x2f0</span>, <span class="Constant">0x300</span>, <span class="Constant">0xa</span>
-<span id="L31" class="LineNr">31 </span>  x, y <span class="SpecialChar">&lt;-</span> <a href='501draw-text.mu.html#L315'>draw-text-wrapping-down-then-right-from-cursor-over-full-screen</a> <span class="Constant">0</span>, <span class="Constant">&quot;wrapped from D&quot;</span>, <span class="Constant">0xa</span>
+<span id="L30" class="LineNr">30 </span>  x <span class="SpecialChar">&lt;-</span> <a href='501draw-text.mu.html#L192'>draw-text-downward</a> <span class="Constant">0</span>, <span class="Constant">&quot;D&quot;</span>, <span class="Constant">0x100</span>, <span class="Constant">0x2f0</span>, <span class="Constant">0x300</span>, <span class="Constant">0xa</span>
+<span id="L31" class="LineNr">31 </span>  <a href='501draw-text.mu.html#L309'>draw-text-wrapping-down-then-right-from-cursor-over-full-screen</a> <span class="Constant">0</span>, <span class="Constant">&quot;wrapped from D&quot;</span>, <span class="Constant">0xa</span>
 <span id="L32" class="LineNr">32 </span><span class="Delimiter">}</span>
 </pre>
 </body>
diff --git a/html/baremetal/ex7.mu.html b/html/baremetal/ex7.mu.html
index f45d38dc..843225d1 100644
--- a/html/baremetal/ex7.mu.html
+++ b/html/baremetal/ex7.mu.html
@@ -69,7 +69,7 @@ if ('onhashchange' in window) {
 <span id="L11" class="LineNr">11 </span><span class="muComment"># k, l.</span>
 <span id="L12" class="LineNr">12 </span>
 <span id="L13" class="LineNr">13 </span><span class="PreProc">fn</span> <span class="muFunction"><a href='ex7.mu.html#L13'>main</a></span> <span class="Delimiter">{</span>
-<span id="L14" class="LineNr">14 </span>  <span class="PreProc">var</span> key/<span class="Constant">eax</span>: byte <span class="SpecialChar">&lt;-</span> <a href='102keyboard.subx.html#L3'>read-key</a> <span class="Constant">0</span>
+<span id="L14" class="LineNr">14 </span>  <span class="PreProc">var</span> key/<span class="Constant">eax</span>: byte <span class="SpecialChar">&lt;-</span> <a href='102keyboard.subx.html#L6'>read-key</a> <span class="Constant">0</span>
 <span id="L15" class="LineNr">15 </span>  <span class="Delimiter">{</span>
 <span id="L16" class="LineNr">16 </span>    compare key, <span class="Constant">0x68</span>  <span class="muComment"># 'h'</span>
 <span id="L17" class="LineNr">17 </span>    <span class="PreProc">break-if-!=</span>
diff --git a/html/baremetal/mu-init.subx.html b/html/baremetal/mu-init.subx.html
index 59895590..b765f7e0 100644
--- a/html/baremetal/mu-init.subx.html
+++ b/html/baremetal/mu-init.subx.html
@@ -63,12 +63,22 @@ if ('onhashchange' in window) {
 <span id="L9" class="LineNr"> 9 </span><span class="subxComment"># initialize stack</span>
 <span id="L10" class="LineNr">10 </span>bd/copy-to-ebp 0/imm32
 <span id="L11" class="LineNr">11 </span><span class="subxComment"># no heap yet</span>
-<span id="L12" class="LineNr">12 </span>(main)
-<span id="L13" class="LineNr">13 </span>
-<span id="L14" class="LineNr">14 </span><span class="subxComment"># hang indefinitely</span>
-<span id="L15" class="LineNr">15 </span>{
-<span id="L16" class="LineNr">16 </span>  eb/jump <span class="Constant">loop</span>/disp8
-<span id="L17" class="LineNr">17 </span>}
+<span id="L12" class="LineNr">12 </span><span class="subxComment">#</span>
+<span id="L13" class="LineNr">13 </span><span class="subxComment"># always first run tests</span>
+<span id="L14" class="LineNr">14 </span>(run-tests)
+<span id="L15" class="LineNr">15 </span>(<a href='104test.subx.html#L17'>num-test-failures</a>)  <span class="subxComment"># =&gt; eax</span>
+<span id="L16" class="LineNr">16 </span><span class="subxComment"># call main if tests all passed</span>
+<span id="L17" class="LineNr">17 </span>{
+<span id="L18" class="LineNr">18 </span>  3d/compare-eax-and 0/imm32
+<span id="L19" class="LineNr">19 </span>  75/jump-if-!= <span class="Constant">break</span>/disp8
+<span id="L20" class="LineNr">20 </span>  (<a href='500clear-screen.mu.html#L1'>clear-screen</a>)
+<span id="L21" class="LineNr">21 </span>  (main)
+<span id="L22" class="LineNr">22 </span>}
+<span id="L23" class="LineNr">23 </span>
+<span id="L24" class="LineNr">24 </span><span class="subxComment"># hang indefinitely</span>
+<span id="L25" class="LineNr">25 </span>{
+<span id="L26" class="LineNr">26 </span>  eb/jump <span class="Constant">loop</span>/disp8
+<span id="L27" class="LineNr">27 </span>}
 </pre>
 </body>
 </html>