Prose that names a mouse button in words drops the glyph beside it, so a screen reader or text browser reads each click once

Co-Authored-By: Claude Opus 5.5 <[email protected]>

1 files changed, 7 insertions, 9 deletions

diff --git a/docs/typ/reference.typ b/docs/typ/reference.typ
index afbbd899..0f9a9341 100644
--- a/docs/typ/reference.typ
+++ b/docs/typ/reference.typ
@@ -163,7 +163,7 @@ read-only, 0222 write-only.
 
 = look and exec <look-and-exec>
 
-A line written to #file("look") is a #btn("B3") click on it, on the line as
+A line written to #file("look") is a right-click on it, on the line as
 written: its leading blanks are its own (`    return x` finds that
 indented line, and a diff's blank context line ` ` is a look too); only its
 newline and `\r` go. An #file("exec") line's blanks at either end are
@@ -186,8 +186,7 @@ files.
   that is there but will not open fails the write and is named:
   `look: <path>: permission denied`. A zero column is refused, `file:0:0`
   included: columns count from 1.
-- A whole line of a diff pane written to #file("look") is the look a
-  #btn("B3") click on its first column makes. The line is matched in the
+- A whole line of a diff pane written to #file("look") is the look a right-click on its first column makes. The line is matched in the
   pane from its cursor row on, wrapping, and the first match wins.
 - On a PDF pane `:P:H` is hit H of the pane's search on page P, as
   `file.pdf:P:H` is; a hit not there, or any H with no search active, is a
@@ -211,7 +210,7 @@ it opened. A look of `file:12:` reads as `file:12`: a trailing colon is
 dropped, as a click leaves it off. A path too long to repeat whole gives up
 its middle to `…`.
 
-A line written to #file("exec") is a #btn("B2") click:
+A line written to #file("exec") is a middle-click:
 
 - A builtin word runs (#file("/commands") lists them). A builtin that needs
   its argument (#word("Msg"), #word("Mount"), #word("Find")) written bare is
@@ -423,8 +422,7 @@ may lower the contrast of text, the selection or a focus indicator.
 build embeds them.
 
 Resting the pointer on text for about 32 ms (`look_preview_delay_frames`,
-2 frames, in `src/config.zig`; `null` turns it off) tints what a
-#btn("B3") click would look at, with no other effect. A terminal's
+2 frames, in `src/config.zig`; `null` turns it off) tints what a right-click would look at, with no other effect. A terminal's
 #word("Filter") keeps each foreground at least `tty_filter_min_contrast`
 (WCAG 1.5, `src/config.zig`) against its background.
 
@@ -718,7 +716,7 @@ back as a record: run it through #file("ctl") instead.
 == REPLs <repls>
 
 `Repl python` on a terminal's #file("ctl") (or in its tag) binds it as
-that language's REPL: a #btn("B2") click or #key("Tab") on a `.py` body
+that language's REPL: a middle-click or #key("Tab") on a `.py` body
 then types the text into the REPL instead of running it; builtin words,
 tag words, `Exec <text>` and #raw("@`cmd`") words still run. #word("Repl")
 takes the languages a code fence names (ada, bash, c, c_sharp, clojure,
@@ -854,7 +852,7 @@ starts a separate session whose shells do not forward to it.
 = Placement <placement>
 
 `Placement acme` (the default) puts a new pane in the column whose tag
-asked, else the active column (last typed or #btn("B1")-clicked in,
+asked, else the active column (last typed or left-clicked in,
 dropped into, its tag given the keyboard, or given the last new pane),
 never a new column. An empty column it takes whole; #word("New") and
 #file("pane/new") take the bottom half of the column's last pane; a pane
@@ -895,7 +893,7 @@ it was.
   itself do not count); for other shells, from no program holding the
   terminal, typed text or not.
 - *A program's mouse.* A program that tracks the mouse (htop, vim with
-  `mouse=a`) gets #btn("B1")'s clicks and drags and the wheel over its
+  `mouse=a`) gets the left button's clicks and drags and the wheel over its
   grid; Shift-#btn("B1") selects and Shift-wheel scrolls pardes's
   scrollback, while Shift-#btn("B2") and Shift-#btn("B3") go to the program.
   A full-screen program that does not track the mouse gets the wheel as