summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorSadrul Habib Chowdhury <sadrul@users.sourceforge.net>2010-02-16 11:36:55 -0500
committerSadrul Habib Chowdhury <sadrul@users.sourceforge.net>2010-02-16 11:36:55 -0500
commit2f39e64a76b2db7ce5ae88b6c087b8e60a47ce06 (patch)
treeeda1de85060380f0e8c8d09f7a90ce1f95575b01
parent7399960d86d8561aebd68d5fe331b44594decbd0 (diff)
downloadscreen-2f39e64a76b2db7ce5ae88b6c087b8e60a47ce06.tar.gz
Update documentation for queries.
-rw-r--r--src/doc/screen.117
-rw-r--r--src/doc/screen.texinfo16
2 files changed, 32 insertions, 1 deletions
diff --git a/src/doc/screen.1 b/src/doc/screen.1
index 3ac5571..c26bbc8 100644
--- a/src/doc/screen.1
+++ b/src/doc/screen.1
@@ -305,6 +305,22 @@ there is no session to resume. 12 (or more) indicates that there are 2 (or
more) sessions to resume and you should specify which one to choose.
In all other cases \*Q-q\*U has no effect.
.TP 5
+.B \-Q
+Some commands now can be queried from a remote session using this
+flag, e.g. 'screen -Q windows'. The commands will send the
+response to the stdout of the querying process. If there was an
+error in the command, then the querying process will exit with
+a non-zero status.
+
+The commands that can be queried now are:
+ \fBecho\fP
+ \fBinfo\fP
+ \fBlastmsg\fP
+ \fBselect\fP
+ \fBtime\fP
+ \fBtitle\fP
+ \fBwindows\fP
+.TP 5
.BR \-r " [" \fIpid.tty.host ]
.PD 0
.TP 5
@@ -376,7 +392,6 @@ 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
As mentioned, each
diff --git a/src/doc/screen.texinfo b/src/doc/screen.texinfo
index 44d233e..f7371e1 100644
--- a/src/doc/screen.texinfo
+++ b/src/doc/screen.texinfo
@@ -374,6 +374,22 @@ there is no session to resume. 12 (or more) indicates that there are 2 (or
more) sessions to resume and you should specify which one to choose.
In all other cases @samp{-q} has no effect.
+@item -Q
+Some commands now can be queried from a remote session using this
+flag, e.g. 'screen -Q windows'. The commands will send the
+response to the stdout of the querying process. If there was an
+error in the command, then the querying process will exit with
+a non-zero status.
+
+The commands that can be queried now are:
+ @code{echo}
+ @code{info}
+ @code{lastmsg}
+ @code{select}
+ @code{time}
+ @code{title}
+ @code{windows}
+
@item -r [@var{pid.sessionname}]
@itemx -r @var{sessionowner}/[@var{pid.sessionname}]
Resume a detached @code{screen} session. No other options (except