diff options
| author | user <user@clank> | 2026-08-29 20:25:39 +0200 |
|---|---|---|
| committer | user <user@clank> | 2026-08-29 20:25:39 +0200 |
| commit | 31c32f9c20e3dd5045fa053fc8e7e606a8139397 (patch) | |
| tree | 007bf1dfe01b8beda4bd5d00642f060d759d519c /docs/scripting.md | |
| parent | arch: sign the packages and the database, and say whose key (diff) | |
| download | slosh-31c32f9c20e3dd5045fa053fc8e7e606a8139397.tar.gz slosh-31c32f9c20e3dd5045fa053fc8e7e606a8139397.tar.xz slosh-31c32f9c20e3dd5045fa053fc8e7e606a8139397.zip | |
docs: less wordy
Diffstat (limited to 'docs/scripting.md')
| -rw-r--r-- | docs/scripting.md | 5 |
1 files changed, 2 insertions, 3 deletions
diff --git a/docs/scripting.md b/docs/scripting.md index d03184d..54c41ce 100644 --- a/docs/scripting.md +++ b/docs/scripting.md @@ -30,13 +30,12 @@ Panes and tabs are addressed by **id**, so a background tab is scriptable. | `focus` | `id` | | `close` `rerun` | `id`, or 0 for the focused pane | | `clear-shaders` | `id`, or 0 for the focused pane; answers `cleared:0\|1`. The way back from a pane that painted itself unreadable | -| `new-tab` `select-tab` `close-tab` `move-tab` `set-name` | tabs, by `id` or `index` | -| `set-name target="pane"` | a pane's name, which outranks the title its program sets | +| `new-tab` `select-tab` `close-tab` `move-tab` | tabs, by `id` or `index` | | `move-pane` | `id` of the pane, `tab` id to move it into (`0` for a tab of its own, with an optional `name`), `dir:"cols"\|"rows"`. The pane keeps running: same pty, same scrollback | | `float` | bare: toggle a pane [floating](panes.md#floating-a-pane) (`id`, or 0 for the focused one). With any of `x` `y` `w` `h` it *places*: floats first when tiled, re-places when floating, never un-floats; omitted fields keep their value | | `new-float` | a fresh floating shell over the current tab, centred, in the focused pane's directory; answers `id` | | `set-name` | `target:"tab"` (the default, because that is what this verb has always meant) or `"pane"`, `id`, `name`. A pane accepts 0 for the focused one. A pane's name wins over the title the program sets, so this is how a program that keeps announcing something stale gets overruled; an empty `name` clears it and hands the label back. Refusals say `no such pane` or `no such tab`, so a mistyped target is visible in the reply | -| `set-purpose` | `target:"pane"\|"tab"`, `id` (or 0 for the focused pane, and the tab you are in), `purpose`. An empty `purpose` clears the slot *and* unlocks it, handing the label back to the program, because a lock held over an empty string was a state nothing could get out of | +| `set-purpose` | `target:"pane"\|"tab"`, `id` (or 0 for the focused pane, and the tab you are in), `purpose`. An empty `purpose` clears the slot *and* unlocks it, handing the label back to the program | | `dump-layout` `apply-layout` | see [layouts](layouts.md). `dump-layout` takes `tab` (0 for every tab), `relative_to` to write every `cwd=` under that directory instead of absolute, and `suspend` (`as-is` `none` `commands` `all`); it answers `kdl` `panes` `suspended`, and an unknown `tab` is an error rather than an empty document | | `workspaces` | the projects on disk and which of them are open: `roots` says whether any are configured at all, and each entry has `name` `path` `purpose` `layout` (a file path, or "") `mtime` `tab` (0 when closed). See [workspaces](workspaces.md) | | `open-workspace` | `name` or `path`, and `suspended`; answers `tab` `purpose` `path` `created` `tabs` `honoured`. Already open means focused, with `created:false` | |
