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

[Sadrul Habib Chowdhury]

On Sun, Aug 5, 2012 at 10:54 AM, Gregor Zattler <address@hidden> wrote:

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.


address@hidden -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.

address@hidden table

Thanks! Pushed (http://git.savannah.gnu.org/cgit/screen.git/commit/?id=b4a43d4b67a753b2af93fc3a1c85dd9aa0378ef8)

Sadrul

 

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