summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
Diffstat (limited to 'docs')
-rw-r--r--docs/fs.md5
-rw-r--r--docs/tags.md9
2 files changed, 13 insertions, 1 deletions
diff --git a/docs/fs.md b/docs/fs.md
index 864bfd12..985e36a1 100644
--- a/docs/fs.md
+++ b/docs/fs.md
@@ -156,7 +156,10 @@ effect, as acme's ctl does. Blank lines are skipped. A mount cuts a big
write into pieces of at most one message (msize 64 KiB, 65536 negotiated,
less the header), and
each line runs once it is whole. A write that does not fill its message is
-whole, so its last line runs even without a newline (`printf Save > exec`). An `Edit` whose `{` or
+whole, so its last line runs even without a newline (`printf Save > exec`),
+unless it is a multiple of 4096 bytes: that is where a writer's buffer (stdio,
+a mount's page cache) filled and cut a line, so its tail waits for the next
+write or the close. An `Edit` whose `{` or
`a`/`c`/`i` text is still open waits for the next write on that open, and
fails at the close if it never ends (``unmatched `{'``). A line held past
1 MiB is refused.
diff --git a/docs/tags.md b/docs/tags.md
index 993e8c0d..51977390 100644
--- a/docs/tags.md
+++ b/docs/tags.md
@@ -30,6 +30,15 @@ A tag word runs as acme's does, in the pane's directory with no file named:
or select the name and middle-click `wc`, which takes a held selection as its
argument.
+A program that tracks the mouse gets it; hold Shift for pardes's own. In
+raw terminal input, a program that asked for the mouse (xterm's 1000, 1002
+or 1003: htop, vim with `mouse=a`, codex) gets the clicks, drags and wheel
+over its grid, reported in the format it chose and with its modifiers.
+Shift-click selects, executes and looks as ever, and Shift-wheel scrolls
+pardes's scrollback. A full-screen program that does not track the mouse
+gets the wheel as arrow keys (xterm's alternate scroll, 1007). Tags, grips
+and gutters stay pardes's.
+
`Repl python` in a terminal's tag binds it as that language's REPL
([fs.md](fs.md#repls)). `Repl` takes the languages a code fence names: ada,
bash, c, c_sharp, clojure, cpp, css, elixir, erlang, fortran, go, haskell,