summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
Diffstat (limited to 'docs')
-rw-r--r--docs/fs.md9
1 files changed, 8 insertions, 1 deletions
diff --git a/docs/fs.md b/docs/fs.md
index d46e3d21..90849a58 100644
--- a/docs/fs.md
+++ b/docs/fs.md
@@ -198,7 +198,14 @@ Closing the open is the only way back, as with rio's `consctl`.
`pty/run` runs one line at a terminal's prompt and answers how it ended, on
the same open (factotum's `rpc` shape): write the line, then read `exit N`
-once the command has ended and the shell is back at a prompt. It reads
+once the command has ended and the shell is back at a prompt, followed by
+what it printed. The output is what the screen showed between the command's
+start and end marks: stderr interleaved, `\r` progress collapsed to its last
+state, no colour; a full-screen program (vim, less) leaves none, and rows a
+program redrew above its start are missed. Only its last 64 KiB are kept,
+from a line start, and the header then reads `exit N cut M` (M bytes left
+out), or `exit N cut` when its start scrolled out of the history. The header
+is always the whole first line. It reads
`busy` at once when a command is running, text is typed at the prompt or the
shell has not drawn its first prompt; `error not run` when the shell refused
the line without running it (a fish syntax error; the line is taken back off