aboutsummaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authoruser <user@clank>2026-09-02 16:24:41 +0200
committeruser <user@clank>2026-09-02 16:24:41 +0200
commitc58a875ef3bcb464cdbea72bdbd0a874b6f93729 (patch)
treef2000cae2b8ca1f110f344080dde1d70114b15ea /docs
parentslosh --install-terminfo: the binary carries its own terminfo entry (diff)
downloadslosh-c58a875ef3bcb464cdbea72bdbd0a874b6f93729.tar.gz
slosh-c58a875ef3bcb464cdbea72bdbd0a874b6f93729.tar.xz
slosh-c58a875ef3bcb464cdbea72bdbd0a874b6f93729.zip
pty: install the terminfo entry implicitly when it is missing everywhere
The lookup miss now writes the embedded entry to ~/.terminfo and uses it, so a bare box gets the full TERM with no step at all. An entry that exists anywhere is respected -- possibly newer, certainly somebody's -- and a HOME that cannot be written leaves the xterm-256color fallback standing. --install-terminfo stays as the by-hand spelling; the writer moved to pty.c where the panes are.
Diffstat (limited to 'docs')
-rw-r--r--docs/slosh.127
1 files changed, 13 insertions, 14 deletions
diff --git a/docs/slosh.1 b/docs/slosh.1
index cce0b64..6436f6a 100644
--- a/docs/slosh.1
+++ b/docs/slosh.1
@@ -152,12 +152,9 @@ Write the
.B xterm-ghostty
terminfo entry the binary carries into
.I ~/.terminfo
-(no root, no package), so panes on a machine without ghostty's entry
-get the full
-.B TERM
-instead of the
-.B xterm-256color
-fallback.
+(no root, no package).
+Sessions do this on their own when the entry is missing everywhere; the
+flag is the by-hand spelling, for provisioning and for saying so.
See ENVIRONMENT.
.TP
.BI \-\-server\ name
@@ -364,14 +361,16 @@ Set in every pane:
.TP
.B TERM
.B xterm-ghostty
-when the machine's terminfo database has the entry (it ships with ghostty),
-.B xterm-256color
-when it does not: an entry curses cannot find makes editors exit on
-the spot and backspace guess.
-.B slosh \-\-install\-terminfo
-puts the real entry in
-.IR ~/.terminfo ;
-new sessions then use it.
+\(en found in the machine's terminfo database, or, when it is missing
+everywhere, installed into
+.I ~/.terminfo
+from the copy the binary carries (an entry curses cannot find makes
+editors exit on the spot and backspace guess).
+Only when even that write fails (no
+.BR $HOME ,
+read-only) do panes get
+.BR xterm-256color ,
+and everything still works.
.TP
.B SLOSH
.B 1