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.

1 files 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.