aboutsummaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authoruser <user@clank>2026-09-10 16:32:10 +0200
committeruser <user@clank>2026-09-10 16:32:10 +0200
commita2d08f4876226446c0052f033e8afea2f2ffbbf1 (patch)
treeac77189b9c928939202adca4a43298730bccd8d2 /docs
parentsidebar: the new-tab button says what it is, given a row to say it on (diff)
downloadslosh-a2d08f4876226446c0052f033e8afea2f2ffbbf1.tar.gz
slosh-a2d08f4876226446c0052f033e8afea2f2ffbbf1.tar.xz
slosh-a2d08f4876226446c0052f033e8afea2f2ffbbf1.zip
sidebar: statuses wear italic instead of an indent, and can wear colour
Three columns of indent is a fifth of a sixteen-column sidebar, spent saying 'this belongs to the row above'. The slant says it in none: a status now starts in the same column its tab's name starts in, and is set in italic. That also survives the monochrome themes in contrib, where a colour-only distinction would have had nothing to spend. tab_status_fg / tab_status_bg are there for themes that do have colour to spend. The fg follows tab_count when a theme does not name it -- the same declared/derived split apply_scrolled makes -- so the six themes in contrib get coherent status rows without a line added to any of them. The bg is unset by default, because a band is opt-in and 'none' is what a translucent terminal wants; the row is padded so a band that *is* set covers the row rather than the words on it. Two things fell out. The padding loop existed three times and is now pad_cells. And cb_color wrote #000000 for an unset colour, so quietly pinned attach_bg -- 'gray ink on the terminal's own background', says its comment -- to a black band. Unset colours are now written commented out, the same trick the states block uses for what it wants re-derived rather than pinned.
Diffstat (limited to 'docs')
-rw-r--r--docs/panes.md6
1 files changed, 5 insertions, 1 deletions
diff --git a/docs/panes.md b/docs/panes.md
index ab9bd08..3100b78 100644
--- a/docs/panes.md
+++ b/docs/panes.md
@@ -81,7 +81,11 @@ point — and a pane that died shows how instead (`exited: status 3`). At most
`tab_bar_status` rows per tab (3 by default, 0 turns it off); more than that
and the last row is an ellipsis rather than a status pretending the list is
complete. **Clicking a status row jumps to the pane that said it**, across
-tabs. The top strip has one row and no room for any of this, which is half of
+tabs. A status is set in italic rather than indented under its tab — the slant
+says "this belongs to the row above" without spending columns a narrow sidebar
+has none of, and says it on a monochrome theme too. `tab_status_fg` and
+`tab_status_bg` are yours if you want colour as well; unset, the first follows
+`tab_count` and the second leaves your terminal's own background alone. The top strip has one row and no room for any of this, which is half of
why the sidebar exists.
**An unnamed tab borrows the directory its focused pane is in** — the