diff options
Diffstat (limited to 'docs/typ/reference.typ')
| -rw-r--r-- | docs/typ/reference.typ | 16 |
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 |