diff options
| author | Gabriel Schneider <[email protected]> | 2026-09-30 20:57:49 -0300 |
|---|---|---|
| committer | Gabriel Schneider <[email protected]> | 2026-10-01 00:12:17 -0300 |
| commit | 6a815117d242688c947a1788e4ffda9ff2bce959 (patch) | |
| tree | 311853ee7195e7b1cbd32cf130ec0f3458f72b2c /docs | |
| parent | c2a1b54651be6b2532d48825d913b747a0edbea8 (diff) | |
| download | pardes-6a815117d242688c947a1788e4ffda9ff2bce959.tar.gz pardes-6a815117d242688c947a1788e4ffda9ff2bce959.zip | |
A shell command from the workspace's or a column's tag runs as a command pane in the session's directory, never typed into the terminal with the keyboard
A command clicked in a header tag, or written to /tagexec or a
column's exec, was typed into the active terminal when it sat at an
empty prompt, so it ran in that pane's directory and left no run or
exit record. It now always gets a command pane of its own in the
session's directory, as acme's row and column tags have no directory
but the session's. tags.md writes the rule down: pane words act on the
column's active pane, a column's words on the column, shell commands
as their own panes, and over 9P a pane's word is refused.
Co-Authored-By: Claude Opus 5.5 <[email protected]>
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/tags.md | 23 |
1 files changed, 17 insertions, 6 deletions
diff --git a/docs/tags.md b/docs/tags.md index eb16cb2a..81ae99a7 100644 --- a/docs/tags.md +++ b/docs/tags.md @@ -1,12 +1,23 @@ # Tags and columns Pardes has three levels of command text: the workspace tag, a tag per -column, and each pane's tag. A column tag's words act on that column and run -in its active pane (its first pane when focus comes from another column). A -command or `Tty` run from the workspace or a column tag starts in the -session's directory (where pardes started), as acme's row and column tags -have none of their own; one run from a pane's tag or text starts in that -pane's directory. Over 9P the tags are `/tag`, `/col/<n>/tag` and +column, and each pane's tag. The rule for the workspace and column tags: + +- A builtin that acts on a pane (`Del`, `Save`, `Undo`) acts on the + column's active pane (its first pane when focus comes from another + column); from the workspace tag, on the pane with the keyboard. +- A column's own words (`New`, `Tty`, `Delcol`) act on that column. +- A shell command runs as a command pane of its own, with `run` and `exit` + records, in the session's directory (where pardes started), as acme's row + and column tags have none of their own. It is never typed into the + terminal that has the keyboard. `Tty` starts there too. +- Over 9P (`/tagexec`, `col/<n>/exec`) there is no click to say which pane + is meant, so a pane's word written there is refused, pointing at + `pane/<n>/ctl`; the tag's own words and shell commands run as above. + +One run from a pane's tag or text starts in that pane's directory, and a +shell command there is typed into the pane when it is a terminal at its +prompt. Over 9P the tags are `/tag`, `/col/<n>/tag` and `/pane/<n>/tag` ([fs.md](fs.md#columns-and-tags)). ## Default words |