From 8ffd5458ff850ae556069ed61ec111cefa0a31ea Mon Sep 17 00:00:00 2001 From: nicm Date: Wed, 13 Mar 2024 11:25:50 +0000 Subject: [PATCH] Make the attach-session description clearer - do not mention creating a client which is not important, explicitly say the session must exist, and mention new-session and new-session -A. Prompted by Theo. --- tmux.1 | 12 ++++++++++-- 1 file changed, 10 insertions(+), 2 deletions(-) diff --git a/tmux.1 b/tmux.1 index 62ab9b4f..32215371 100644 --- a/tmux.1 +++ b/tmux.1 @@ -1036,9 +1036,17 @@ The following commands are available to manage clients and sessions: .D1 Pq alias: Ic attach If run from outside .Nm , -create a new client in the current terminal and attach it to +attach to +.Ar target-session +in the current terminal. +.Ar target-session +must already exist - to create a new session, see the +.Ic new-session +command (with +.Fl A +to create or attach). +If used from inside, switch the currently attached session to .Ar target-session . -If used from inside, switch the current client. If .Fl d is specified, any other clients attached to the session are detached.