diff --git a/crates/tty7-cli/src/cli.rs b/crates/tty7-cli/src/cli.rs
index fe9a5039..b6df05eb 100644
--- a/crates/tty7-cli/src/cli.rs
+++ b/crates/tty7-cli/src/cli.rs
@@ -572,7 +572,18 @@ pub enum ServerCmd {
     #[command(about = "Stop the server; sessions end")]
     Stop,
 
-    #[command(about = "Stop, then start")]
+    #[command(
+        about = "Stop, then start; sessions end",
+        long_about = "Stop, then start.\n\n\
+                      Sessions end, exactly as `stop` says of itself: every pane the \
+                      server is running is a child of it, and this kills the server. The \
+                      workspaces survive — the tree is on disk — so the layout is still \
+                      there afterwards with dead leaves the GUI revives into fresh \
+                      shells. What does not survive is what those shells were running.\n\n\
+                      The server can hand panes to a new build of itself with their pids \
+                      and ptys intact, which is how an update keeps your sessions, but \
+                      that path is not this one: this stops and starts."
+    )]
     Restart,
 
     #[command(about = "Version, uptime, panes, links")]