[screen-devel] [PATCH] amend documentation of -X option

[Gregor Zattler]

Hi screen developers,

I was'nt able to learn from the docs how to specifiy the screen
session a screen -X command should use but had to google for this
information.  To me the wording of the documantation regarding
the -X and -S options didn't help since -S is supposed for "new"
sessions. 

Perhaps this patch helps other users:


diff --git a/src/doc/screen.1 b/src/doc/screen.1
index bbb5a3d..98674eb 100644
--- a/src/doc/screen.1
+++ b/src/doc/screen.1
@@ -394,10 +394,12 @@ refuses to attach from within itself.
 But when cascading multiple screens, loops are not detected; take care.
 .TP 5
 .B \-X
-Send the specified command to a running screen session. You can use
-the \fB-d\fP or \fB-r\fP option to tell screen to look only for
-attached or detached screen sessions. Note that this command doesn't
-work if the session is password protected.
+Send the specified command to a running screen session. You may
+use the \fB-S\fP option to specify the screen session if you have
+several screen sessions running. You can use the \fB-d\fP or
+\fB-r\fP option to tell screen to look only for attached or
+detached screen sessions. Note that this command doesn't work if
+the session is password protected.
 
 .SH "DEFAULT KEY BINDINGS"
 .ta 12n 26n
diff --git a/src/doc/screen.texinfo b/src/doc/screen.texinfo
index e39003a..d721647 100644
--- a/src/doc/screen.texinfo
+++ b/src/doc/screen.texinfo
@@ -458,10 +458,11 @@ But when cascading multiple screens, loops are not 
detected; take care.
 
 
 @item -X
-Send the specified command to a running screen session. You can use
-the @code{-d} or @code{-r} option to tell screen to look only for 
-attached or detached screen sessions. Note that this command doesn't
-work if the session is password protected.
+Send the specified command to a running screen session. You may use
+the @code{-S} option to specify the screen session if you have several
+running. You can use the @code{-d} or @code{-r} option to tell screen
+to look only for attached or detached screen sessions. Note that this
+command doesn't work if the session is password protected.
 
 @end table
 


Ciao, Gregor
-- 
 -... --- .-. . -.. ..--.. ...-.-