summaryrefslogtreecommitdiff
path: root/docs/config.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/config.md')
-rw-r--r--docs/config.md22
1 files changed, 16 insertions, 6 deletions
diff --git a/docs/config.md b/docs/config.md
index 921f817e..0332d854 100644
--- a/docs/config.md
+++ b/docs/config.md
@@ -111,9 +111,16 @@ themes and all imported names remain available.
`FocusTint` toggles the focused pane and column tag tints; it is on by default.
Workspace, column and pane command text can be edited directly; see
[editable tags](tags.md) for naming and saved-workspace behavior.
-`ColumnTags` toggles the column command row in both GUI and TTY; it is on by
-default. Add `ColumnTags` to startup configuration to reclaim that row on a
-compact screen. Hiding it preserves your custom column commands.
+The column command row is always shown; an old `ColumnTags` init line is
+ignored with a message.
+`Placement acme` (the default) puts new panes where acme would, in the active
+column; `Placement pardes` brings back pardes's own rules, which open a first
+document in a column of its own. See [where new panes go](tags.md#where-new-panes-go).
+`BootShell keep` (the default) leaves a shell alone when a document is dragged
+into the left column beside it, whatever it holds; `BootShell replace` closes
+such a shell there when it is the column's only one and nobody has typed
+into it (no scrollback, cursor still on the first prompt line), the boot's
+placeholder giving its rows to the document. Bare `BootShell` flips it.
`Verbose` toggles the message-row announcement every builtin makes of its own
name before it runs; it is on by default, and the builtins that own the message
row themselves (`Msg`) never announce. Turning it off leaves the row to the
@@ -314,7 +321,7 @@ name, thirteen required RGB roles (`sel_bg`, `sel_fg`, `tag_bg`, `tag_fg`,
`box`, `box_dim`, `kw`, `str`, `num`, `comment`, `lineno`, `scroll_track`,
`scroll_thumb`), nullable `bg`/`fg`, and either a 16-color RGB `palette` or
`null`. Optional nullable RGB roles extend this format:
-`tag_active_bg`, `tag_active_fg`, `tag_name_fg`, `tag_active_name_fg`, `border`, `lineno_active`, `search_bg`, `search_fg`,
+`tag_active_bg`, `tag_active_fg`, `tag_name_fg`, `tag_active_name_fg`, `border`, `empty_col`, `lineno_active`, `search_bg`, `search_fg`,
`diagnostic_error`, `diagnostic_warning`, `diagnostic_info`,
`diagnostic_hint`, `tag_sel_bg`, `tag_rule`, `box_border` and `box_dirty`;
`sweep_bg` and `sweep_fg` take three triples, and `rule_px` and `rail_px` a
@@ -626,7 +633,10 @@ writes a timestamped file in the default directory.
A restored terminal comes back live: its recorded output (the last MiB of it)
is replayed as history, a dim `── restored history ──` line marks where it
-ends, and a new shell starts below it in the directory the old one was in. A
+ends, and a new shell starts below it in the directory the old one was in,
+the same shell it ran (a `Tty bash` pane comes back running bash). A
view left scrolled back stays where it was. Only the shell is new; nothing the
-old one was running is restarted. The web shell, which has no ptys, still
+old one was running is restarted. A command pane comes back finished, with
+what it printed and its `exit N`, and is not run again (a command still
+running when dumped comes back as `exit ?`). The web shell, which has no ptys, still
shows the history alone.