summaryrefslogtreecommitdiff
path: root/docs/typ/reference.typ
diff options
context:
space:
mode:
Diffstat (limited to 'docs/typ/reference.typ')
-rw-r--r--docs/typ/reference.typ13
1 files changed, 13 insertions, 0 deletions
diff --git a/docs/typ/reference.typ b/docs/typ/reference.typ
index 7360179f..d359489b 100644
--- a/docs/typ/reference.typ
+++ b/docs/typ/reference.typ
@@ -1172,6 +1172,19 @@ says the session is gone); with
waits there. Bare `pardes` in a pane refuses and names `--nested`, which
starts a separate session whose shells do not forward to it.
+A first word that names a command is that command instead (a file named
+so is `./ps`, or after `--`): `ps`, `attach`, `kill` and `new` for
+sessions; `do WORD` and `words` for the builtins of #file("/commands");
+`fs` for the tree, through a 9P client in the binary, a refusal in the
+session's own words; `help`, `completion`, `skill` and `version`. A
+command that acts on a session takes `-s NAME`, else `$PARDES_9P`, else
+the only one running; with none, `help`, `words`, `completion` and a read
+of #file("/README"), #file("/commands") or #file("/ctl") ask a core made
+in the command's own process. What follows is `pardes help --all`, printed
+by the build (docs/typ/command-line.txt), so it is what the binary says.
+
+#raw(read("command-line.txt"), block: true)
+
= Placement <placement>
A new pane goes in the column whose tag asked, else the active column (last typed or left-clicked in,