From 1d617168275327e6f8c3455a16d7b9d737bacdcc Mon Sep 17 00:00:00 2001
From: nicm <nicm@openbsd.org>
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.

---
 usr.bin/tmux/tmux.1 | 16 ++++++++++++----
 1 file changed, 12 insertions(+), 4 deletions(-)

diff --git a/usr.bin/tmux/tmux.1 b/usr.bin/tmux/tmux.1
index 43fbad273fa..b0f6a0d58f9 100644
--- a/usr.bin/tmux/tmux.1
+++ b/usr.bin/tmux/tmux.1
@@ -1,4 +1,4 @@
-.\" $OpenBSD: tmux.1,v 1.936 2024/02/13 08:10:23 nicm Exp $
+.\" $OpenBSD: tmux.1,v 1.937 2024/03/13 11:25:50 nicm Exp $
 .\"
 .\" Copyright (c) 2007 Nicholas Marriott <nicholas.marriott@gmail.com>
 .\"
@@ -14,7 +14,7 @@
 .\" IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING
 .\" OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 .\"
-.Dd $Mdocdate: February 13 2024 $
+.Dd $Mdocdate: March 13 2024 $
 .Dt TMUX 1
 .Os
 .Sh NAME
@@ -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.
-- 
2.20.1