aboutsummaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authoruser <user@clank>2026-09-02 16:22:03 +0200
committeruser <user@clank>2026-09-02 16:22:03 +0200
commitf9986df0da09cc692e168e33ef9ccfab5b9d2faf (patch)
treec0cc554269af4260a41eca2c3ea1a56efb4a730f /docs
parentpty: fall back to xterm-256color where xterm-ghostty has no terminfo (diff)
downloadslosh-f9986df0da09cc692e168e33ef9ccfab5b9d2faf.tar.gz
slosh-f9986df0da09cc692e168e33ef9ccfab5b9d2faf.tar.xz
slosh-f9986df0da09cc692e168e33ef9ccfab5b9d2faf.zip
slosh --install-terminfo: the binary carries its own terminfo entry
The xterm-256color fallback works everywhere; the real entry is better, and a tarball user on a bare box had no easy way to get it. The entry is generated from the vendored tree (contrib/terminfo, so it describes the terminal core we actually ship), compiled with tic, embedded as bytes, and written to ~/.terminfo under every name it answers to, letter and Darwin-hashed layouts both. No root, no package, no conflict with a ghostty installed later. Proven end to end in a mount namespace: bare box falls back, installs, and the next pane says xterm-ghostty.
Diffstat (limited to 'docs')
-rw-r--r--docs/slosh.117
1 files changed, 17 insertions, 0 deletions
diff --git a/docs/slosh.1 b/docs/slosh.1
index 9bb623e..cce0b64 100644
--- a/docs/slosh.1
+++ b/docs/slosh.1
@@ -147,6 +147,19 @@ Print the version and exit.
It is the same string the status line shows, so \(lqwhich build is
this\(rq has one answer whether you ask the binary or the session.
.TP
+.B \-\-install\-terminfo
+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.
+See ENVIRONMENT.
+.TP
.BI \-\-server\ name
Run a session's server in the foreground.
Internal: attaching spawns this for you.
@@ -355,6 +368,10 @@ 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.
.TP
.B SLOSH
.B 1