From 76edff82efbe2f9c228e33b728d2e5f363c8509c Mon Sep 17 00:00:00 2001 From: Sadrul Habib Chowdhury Date: Sat, 7 Feb 2009 19:44:54 -0500 Subject: Allow highlighting bell/monitor windows in caption The command is 'rendition'. Details in man-page. The defaults are currently set in a way to make sure that the new settings are noticeable. This changeset is preferred over either of the patches in savannah #18382, because it allows specifying the renditions for both bell and monitor windows, and is flexible enough that new renditions can be added if desired. --- src/doc/screen.1 | 9 +++++++++ 1 file changed, 9 insertions(+) (limited to 'src/doc/screen.1') diff --git a/src/doc/screen.1 b/src/doc/screen.1 index 879dc83..53af799 100644 --- a/src/doc/screen.1 +++ b/src/doc/screen.1 @@ -2518,6 +2518,15 @@ Unlinks the screen-exchange file used by the commands \*Qwritebuf\*U and \*Qreadbuf\*U. .sp .ne 3 +.B "rendition bell" | monitor | so +.RB "\fIattr\fR " [ \fIcolor ] +.PP +Change the way +.I screen +renders the titles of windows that have monitor or bell flags set in caption or hardstatus or windowlist. See the \*QSTRING ESCAPES\*U chapter for the syntax of the modifiers. +The default for monitor is currently \*Q=u dd\*U (underline, default colors) and for bell \*Q=B dd\*U (blink, default colors). +.sp +.ne 3 .B "reset" .PP Reset the virtual terminal to its \*Qpower-on\*U values. Useful when strange -- cgit v1.2.1 From 903c7604f7715f0c9453d4e5dba995c2ac927769 Mon Sep 17 00:00:00 2001 From: Sadrul Habib Chowdhury Date: Fri, 13 Feb 2009 22:51:42 -0500 Subject: Customizable digraphs This closes a debian wishlist more than 10 years old (#25096), and also a less old feature request on savannah (#25279). --- src/doc/screen.1 | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) (limited to 'src/doc/screen.1') diff --git a/src/doc/screen.1 b/src/doc/screen.1 index 53af799..ec695e7 100644 --- a/src/doc/screen.1 +++ b/src/doc/screen.1 @@ -1645,7 +1645,7 @@ Shows a tabular listing of all currently connected user front-ends (displays). This is most useful for multiuser sessions. .sp .ne 3 -.BR "digraph " [ \fIpreset ] +.BR "digraph " [ \fIpreset [ \fI unicode-value ] ] .PP This command prompts the user for a digraph sequence. The next two characters typed are looked up in a builtin table and the @@ -1659,6 +1659,11 @@ number instead. The optional argument is treated as user input, thus one can create an \*Qumlaut\*U key. For example the command "bindkey ^K digraph '"'" enables the user to generate an a-umlaut by typing CTRL-K a. +When a non-zero +.I unicode-value +is specified, a new digraph is created with the specified preset. The digraph is unset +if a zero value is provided for the +.I unicode-value. .sp .ne 3 .B dumptermcap -- cgit v1.2.1 From 476039279dcd62c8759b8b15709371d77a85d380 Mon Sep 17 00:00:00 2001 From: Micah Cowan Date: Mon, 23 Feb 2009 21:18:03 -0800 Subject: $STY still reflects the old session name, but only in existing shells. --- src/doc/screen.1 | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) (limited to 'src/doc/screen.1') diff --git a/src/doc/screen.1 b/src/doc/screen.1 index ec695e7..54ae2d2 100644 --- a/src/doc/screen.1 +++ b/src/doc/screen.1 @@ -2626,7 +2626,8 @@ latter is useful if used with screen's \*Q-X\*U option. Rename the current session. Note, that for \*Qscreen -list\*U the name shows up with the process-id prepended. If the argument \*Qname\*U is omitted, the name of this session is displayed. Caution: The $STY -environment variables still reflects the old name. This may result in +environment variables will still reflect the old name in pre-existing +shells. This may result in confusion. The default is constructed from the tty and host names. .sp -- cgit v1.2.1 From 7fd224a668c06566f4e2c9ace4a35ad9a1e4214a Mon Sep 17 00:00:00 2001 From: Sadrul Habib Chowdhury Date: Sat, 28 Feb 2009 00:23:28 -0500 Subject: Update manual for 'rendition' Fixes #25668. --- src/doc/screen.1 | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'src/doc/screen.1') diff --git a/src/doc/screen.1 b/src/doc/screen.1 index 54ae2d2..314b758 100644 --- a/src/doc/screen.1 +++ b/src/doc/screen.1 @@ -2529,7 +2529,7 @@ Unlinks the screen-exchange file used by the commands \*Qwritebuf\*U and Change the way .I screen renders the titles of windows that have monitor or bell flags set in caption or hardstatus or windowlist. See the \*QSTRING ESCAPES\*U chapter for the syntax of the modifiers. -The default for monitor is currently \*Q=u dd\*U (underline, default colors) and for bell \*Q=B dd\*U (blink, default colors). +The default for monitor is currently \*Q=b \*U (bold, active colors) and for bell \*Q=ub \*U (underline, bold and active colors). .sp .ne 3 .B "reset" -- cgit v1.2.1 From 976566d89d71f887df8f89f5ebcca73b29f9d73c Mon Sep 17 00:00:00 2001 From: Curtis Brown Date: Tue, 7 Jul 2009 18:43:07 -0700 Subject: Document number command's new +/- feature. --- src/doc/screen.1 | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) (limited to 'src/doc/screen.1') diff --git a/src/doc/screen.1 b/src/doc/screen.1 index 314b758..80c6483 100644 --- a/src/doc/screen.1 +++ b/src/doc/screen.1 @@ -2305,11 +2305,12 @@ some time it restarts to accept characters, screen will unblock the display and redisplay the updated window contents. .sp .ne 3 -.BR "number " [ \fIn ] +.BR "number " [[+|-] \fIn ] .PP -Change the current windows number. If the given number \fIn\fP is already +Change the current window's number. If the given number \fIn\fP is already used by another window, both windows exchange their numbers. If no argument is -specified, the current window number (and title) is shown. +specified, the current window number (and title) is shown. Using `+' or `-' +will change the window's number by the relative amount specified. .sp .ne 3 .BR "obuflimit " [ \fIlimit ] -- cgit v1.2.1 From 97708d5800ac845b4c3a25d96d544f0dafa735d7 Mon Sep 17 00:00:00 2001 From: Curtis Brown Date: Mon, 13 Jul 2009 21:08:35 -0700 Subject: Document the new "-v" argument to the split command. --- src/doc/screen.1 | 11 +++++++---- 1 file changed, 7 insertions(+), 4 deletions(-) (limited to 'src/doc/screen.1') diff --git a/src/doc/screen.1 b/src/doc/screen.1 index 80c6483..b781e3a 100644 --- a/src/doc/screen.1 +++ b/src/doc/screen.1 @@ -509,7 +509,7 @@ automatic margins on and off). .PD Send a control-s to the current window. .IP "\fBC-a S\fP (split)" -Split the current region into two new ones. +Split the current region horizontally into two new ones. See also \fIonly, remove, focus\fP. .IP "\fBC-a t\fP" .PD 0 @@ -582,6 +582,8 @@ Shows where comes from, where it went to and why you can use it. .IP "\fBC-a _\fP (silence)" Start/stop monitoring the current window for inactivity. +.IP "\fBC-a |\fP (split -v)" +Split the current region vertically into two new ones. .IP "\fBC-a *\fP (displays)" Show a listing of all currently attached displays. @@ -2729,12 +2731,13 @@ The default is currently \*Q=s dd\*U (standout, default colors). .sp .ne 3 .B split +.RB [ -v ] .PP Split the current region into two new ones. All regions on the display are resized to make room for the new region. The blank -window is displayed on the new region. Use the \*Qremove\*U or the -\*Qonly\*U command to delete regions. -Use \*Qfocus\*U to toggle between regions. +window is displayed on the new region. Splits are made horizontally +unless -v is used. Use the \*Qremove\*U or the \*Qonly\*U command +to delete regions. Use \*Qfocus\*U to toggle between regions. .sp .ne 3 .B "startup_message on\fP|\fBoff" -- cgit v1.2.1 From ac6264f3bb3a792b523123b44477fdfc83cdfc34 Mon Sep 17 00:00:00 2001 From: Curtis Brown Date: Mon, 13 Jul 2009 21:12:02 -0700 Subject: Document deprecated status of sorendition. --- src/doc/screen.1 | 6 +----- 1 file changed, 1 insertion(+), 5 deletions(-) (limited to 'src/doc/screen.1') diff --git a/src/doc/screen.1 b/src/doc/screen.1 index b781e3a..203f45e 100644 --- a/src/doc/screen.1 +++ b/src/doc/screen.1 @@ -2723,11 +2723,7 @@ default screenrc files to have an effect. .B sorendition .RB [ "\fIattr\fR " [ \fIcolor ]] .PP -Change the way -.I screen -does highlighting for text marking and printing messages. -See the \*QSTRING ESCAPES\*U chapter for the syntax of the modifiers. -The default is currently \*Q=s dd\*U (standout, default colors). +This command is deprecated. See "rendition so" instead. .sp .ne 3 .B split -- cgit v1.2.1 From ede107f9d8ca413a21326450090c7090a703fb81 Mon Sep 17 00:00:00 2001 From: Micah Cowan Date: Mon, 13 Jul 2009 21:13:10 -0700 Subject: Typo fix in manpage (Thanks positron). --- src/doc/screen.1 | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'src/doc/screen.1') diff --git a/src/doc/screen.1 b/src/doc/screen.1 index 203f45e..454205b 100644 --- a/src/doc/screen.1 +++ b/src/doc/screen.1 @@ -2009,7 +2009,7 @@ Sets a command that is run after the specified number of seconds inactivity is reached. This command will normally be the \*Qblanker\*U command to create a screen blanker, but it can be any screen command. If no command is specified, only the timeout is set. A timeout of -zero (ot the special timeout \fBoff\fP) disables the timer. +zero (or the special timeout \fBoff\fP) disables the timer. If no arguments are given, the current settings are displayed. .sp .ne 3 -- cgit v1.2.1 From 8c0d8987c3f3d298d164d4ec74a0eb780f5c0015 Mon Sep 17 00:00:00 2001 From: Curtis Brown Date: Tue, 14 Jul 2009 14:14:28 -0700 Subject: Fix keybinding doc glitches. --- src/doc/screen.1 | 2 ++ 1 file changed, 2 insertions(+) (limited to 'src/doc/screen.1') diff --git a/src/doc/screen.1 b/src/doc/screen.1 index 454205b..05b4294 100644 --- a/src/doc/screen.1 +++ b/src/doc/screen.1 @@ -561,6 +561,8 @@ Enter command line mode. .IP "\fBC-a esc\fP (copy)" .PD Enter copy/scrollback mode. +.IP "\fBC-a C-]\fP" +.PD 0 .IP "\fBC-a ]\fP (paste .)" .PD Write the contents of the paste buffer to the stdin queue of the -- cgit v1.2.1 From 94d31dc5e9c6e9b0f493af5661ee17cace454d92 Mon Sep 17 00:00:00 2001 From: Sadrul Habib Chowdhury Date: Tue, 10 Nov 2009 10:54:34 -0500 Subject: Update document for the 'unbindall' command. --- src/doc/screen.1 | 8 ++++++++ 1 file changed, 8 insertions(+) (limited to 'src/doc/screen.1') diff --git a/src/doc/screen.1 b/src/doc/screen.1 index 05b4294..b48453f 100644 --- a/src/doc/screen.1 +++ b/src/doc/screen.1 @@ -2921,6 +2921,14 @@ prompts for one. This command was known as `aka' in previous releases. .sp .ne 3 +.BI "unbindall " +.PP +Unbind all the bindings. This can be useful when +screen is used solely for its detaching abilities, such as when +letting a console application run as a daemon. If, for some reason, +it is necessary to bind commands after this, use 'screen -X'. +.sp +.ne 3 .BI "unsetenv " var .PP Unset an environment variable. -- cgit v1.2.1 From c78d93a1d7bd6c39fa4e2d94ef26907f9ddf308b Mon Sep 17 00:00:00 2001 From: Curtis Brown Date: Mon, 30 Nov 2009 12:46:45 -0500 Subject: More documentation updates. --- src/doc/screen.1 | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) (limited to 'src/doc/screen.1') diff --git a/src/doc/screen.1 b/src/doc/screen.1 index b48453f..e37c4cc 100644 --- a/src/doc/screen.1 +++ b/src/doc/screen.1 @@ -231,7 +231,11 @@ The use of this option is discouraged. turns login mode on or off (for /etc/utmp updating). This can also be defined through the \*Qdeflogin\*U .screenrc command. .TP 5 -.BR \-ls " and " \-list +.BR \-ls " [" \fImatch ] +.PD 0 +.TP 5 +.BR \-list " [" \fImatch ] +.PD does not start .IR screen , but prints a list of @@ -326,7 +330,7 @@ had not been specified. The option is set by default if is run as a login-shell (actually screen uses \*Q-xRR\*U in that case). For combinations with the \fB\-d\fP/\fB\-D\fP option see there. .TP 5 -.B \-s +.BI "\-s " program sets the default shell to the program specified, instead of the value in the environment variable $SHELL (or \*Q/bin/sh\*U if not defined). This can also be defined through the \*Qshell\*U .screenrc command. -- cgit v1.2.1 From 1e4fb57b49754618dc147f397a8a72483fd6c419 Mon Sep 17 00:00:00 2001 From: Sadrul Habib Chowdhury Date: Tue, 15 Dec 2009 12:59:18 -0500 Subject: Allow adding visual notification in caption string. '%P' in caption string will set '%?' to true if the current region is in copy/paste mode. So, if you want to simply change the color etc. of your caption, prepend '%?%P%{XXX}%?' to your caption and you're set ('XXX' stands for the usual attribute/color modifier). If, on the other hand, you want to change the caption string in copy mode, change your caption string to '%?%PCaption for copy mode%:Your usual caption%?'. --- src/doc/screen.1 | 2 ++ 1 file changed, 2 insertions(+) (limited to 'src/doc/screen.1') diff --git a/src/doc/screen.1 b/src/doc/screen.1 index e37c4cc..a811379 100644 --- a/src/doc/screen.1 +++ b/src/doc/screen.1 @@ -3336,6 +3336,8 @@ month number month name .IP n window number +.IP P +sets %? to true if the current region is in copy/paste mode .IP S session name .IP s -- cgit v1.2.1 From 855b8e7b98894e8f94033945720714c235911262 Mon Sep 17 00:00:00 2001 From: Jan Christoph Nordholz Date: Fri, 18 Dec 2009 16:26:41 -0500 Subject: Discourage the use of 'sessionname' (see debian bug #103771). --- src/doc/screen.1 | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) (limited to 'src/doc/screen.1') diff --git a/src/doc/screen.1 b/src/doc/screen.1 index a811379..965567e 100644 --- a/src/doc/screen.1 +++ b/src/doc/screen.1 @@ -2636,8 +2636,9 @@ Rename the current session. Note, that for \*Qscreen -list\*U the name shows up with the process-id prepended. If the argument \*Qname\*U is omitted, the name of this session is displayed. Caution: The $STY environment variables will still reflect the old name in pre-existing -shells. This may result in -confusion. +shells. This may result in confusion. Use of this command is generally +discouraged. Use the \*Q-S\*U command-line option if you want to +name a new session. The default is constructed from the tty and host names. .sp .ne 3 -- cgit v1.2.1 From 04005670529085ef8527608c0ec34b06569f0bd8 Mon Sep 17 00:00:00 2001 From: Jan Christoph Nordholz Date: Fri, 18 Dec 2009 16:28:57 -0500 Subject: Correction in TFM. The builtin 'screen' command can directly reference window IDs up to MAXWIN, not only {0-9}. Additionally mention Debian's MAXWIN default in the man and info pages. --- src/doc/screen.1 | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) (limited to 'src/doc/screen.1') diff --git a/src/doc/screen.1 b/src/doc/screen.1 index 965567e..06e8e64 100644 --- a/src/doc/screen.1 +++ b/src/doc/screen.1 @@ -2576,9 +2576,9 @@ title (a.\|k.\|a.) option (\fB\-t\fP), login options (\fB-l\fP and \fB-ln\fP) and scrollback option (\fB-h\fP ) may be specified with each command. The option (\fB-M\fP) turns monitoring on for this window. The option (\fB-L\fP) turns output logging on for this window. -If an optional number \fIn\fP in the range 0..9 is given, the window -number \fIn\fP is assigned to the newly created window (or, if this -number is already in-use, the next available number). +If an optional number \fIn\fP in the range 0..MAXWIN-1 is given, +the window number \fIn\fP is assigned to the newly created window +(or, if this number is already in-use, the next available number). If a command is specified after \*Qscreen\*U, this command (with the given arguments) is started in the window; otherwise, a shell is created. Thus, if your \*Q.screenrc\*U contains the lines @@ -2624,7 +2624,7 @@ When a new window is established, the first available number is assigned to this window. Thus, the first window can be activated by \*Qselect 0\*U. The number of windows is limited at compile-time by the MAXWIN -configuration parameter. +configuration parameter (which defaults to 40). There are two special WindowIDs, \*Q-\*U selects the internal blank window and \*Q.\*U selects the current window. The latter is useful if used with screen's \*Q-X\*U option. -- cgit v1.2.1 From 3b19a1d343e72e4fa786e9ab514d80303902a2c1 Mon Sep 17 00:00:00 2001 From: Jan Christoph Nordholz Date: Fri, 18 Dec 2009 16:31:18 -0500 Subject: Update documentation for 'nethack'. Document that there are two possible causes for 'nethack on' being activated by default... --- src/doc/screen.1 | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) (limited to 'src/doc/screen.1') diff --git a/src/doc/screen.1 b/src/doc/screen.1 index 06e8e64..1c75652 100644 --- a/src/doc/screen.1 +++ b/src/doc/screen.1 @@ -2289,7 +2289,8 @@ available if .I screen was compiled with the NETHACK flag defined. The default setting is then determined by the presence of the environment -variable $NETHACKOPTIONS. +variable $NETHACKOPTIONS and the file ~/.nethackrc - if either one is present, +the default is \fBon\fP. .sp .ne 3 .B next -- cgit v1.2.1 From f6c4b82a35420b679af178dbcb17f4225723dea3 Mon Sep 17 00:00:00 2001 From: Jan Christoph Nordholz Date: Fri, 18 Dec 2009 16:42:12 -0500 Subject: Clarify the manual a little. Document the fact that when calling 'env=var screen app arg' from inside screen the environment variable will go up in smoke. --- src/doc/screen.1 | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) (limited to 'src/doc/screen.1') diff --git a/src/doc/screen.1 b/src/doc/screen.1 index 1c75652..de3df24 100644 --- a/src/doc/screen.1 +++ b/src/doc/screen.1 @@ -97,7 +97,9 @@ but will instead supply the command name and its arguments to the window manager (specified in the $STY environment variable) who will use it to create the new window. The above example would start the emacs editor (editing prog.c) and switch -to its window. +to its window. - Note that you cannot transport environment variables from +the invoking shell to the application (emacs in this case), because it is +forked from the parent screen process, not from the invoking shell. .PP If \*Q/etc/utmp\*U is writable by .IR screen , -- cgit v1.2.1 From 52efeb8dfc40be5d5ba36253a1dc3af514d0b226 Mon Sep 17 00:00:00 2001 From: Sadrul Habib Chowdhury Date: Sat, 19 Dec 2009 14:23:27 -0500 Subject: Allow no argument to blankerprg. Without any argument, blankerprg will show the command that would be executed on 'blanker'. To unset, use an empty string, i.e. "blankerprg ''". --- src/doc/screen.1 | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) (limited to 'src/doc/screen.1') diff --git a/src/doc/screen.1 b/src/doc/screen.1 index de3df24..bbf7975 100644 --- a/src/doc/screen.1 +++ b/src/doc/screen.1 @@ -1094,7 +1094,8 @@ This command is normally used together with the \*Qidle\*U command. .B blankerprg .RI [ "program args" ] .PP -Defines a blanker program. Disables the blanker program if no +Defines a blanker program. Disables the blanker program if an +empty argument is given. Shows the currently set blanker program if no arguments are given. .sp .ne 3 -- cgit v1.2.1 From f33e5cdecb7bf3b6ae8e4a5c0ca394dd5a06a416 Mon Sep 17 00:00:00 2001 From: Sadrul Habib Chowdhury Date: Tue, 26 Jan 2010 15:15:24 -0500 Subject: Increase the max-window limit. The limit can be increased using the 'maxwin' command. There is still an upper-limit of 2048 windows. --- src/doc/screen.1 | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) (limited to 'src/doc/screen.1') diff --git a/src/doc/screen.1 b/src/doc/screen.1 index bbf7975..3ac5571 100644 --- a/src/doc/screen.1 +++ b/src/doc/screen.1 @@ -2234,7 +2234,8 @@ single statement. .BI "maxwin " num .PP Set the maximum window number screen will create. Doesn't affect -already existing windows. The number may only be decreased. +already existing windows. The number can be increased only when there are no +existing windows. .sp .ne 3 .B meta -- cgit v1.2.1 From 2f39e64a76b2db7ce5ae88b6c087b8e60a47ce06 Mon Sep 17 00:00:00 2001 From: Sadrul Habib Chowdhury Date: Tue, 16 Feb 2010 11:36:55 -0500 Subject: Update documentation for queries. --- src/doc/screen.1 | 17 ++++++++++++++++- 1 file changed, 16 insertions(+), 1 deletion(-) (limited to 'src/doc/screen.1') 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 -- cgit v1.2.1 From 6c6d7edccebb2c33abbf461299f2cea99ecb1a17 Mon Sep 17 00:00:00 2001 From: Sadrul Habib Chowdhury Date: Tue, 16 Feb 2010 12:45:53 -0500 Subject: Make 'number' query-able. --- src/doc/screen.1 | 1 + 1 file changed, 1 insertion(+) (limited to 'src/doc/screen.1') diff --git a/src/doc/screen.1 b/src/doc/screen.1 index c26bbc8..afee22b 100644 --- a/src/doc/screen.1 +++ b/src/doc/screen.1 @@ -316,6 +316,7 @@ The commands that can be queried now are: \fBecho\fP \fBinfo\fP \fBlastmsg\fP + \fBnumber\fP \fBselect\fP \fBtime\fP \fBtitle\fP -- cgit v1.2.1 From a889d858d6baae4d6bc2da98bf6ee82e52ad5fbc Mon Sep 17 00:00:00 2001 From: Sadrul Habib Chowdhury Date: Tue, 16 Feb 2010 13:37:39 -0500 Subject: Error out if a pre-select window is not found. The man-page is updated to show that if the window selected using '-p' cannot be determined with -X or -Q flags, then the command specified will not be executed. Fixes #28783 in savannah. --- src/doc/screen.1 | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) (limited to 'src/doc/screen.1') diff --git a/src/doc/screen.1 b/src/doc/screen.1 index afee22b..b580b45 100644 --- a/src/doc/screen.1 +++ b/src/doc/screen.1 @@ -293,7 +293,8 @@ Preselect a window. This is useful when you want to reattach to a specific window or you want to send a command via the \*Q-X\*U option to a specific window. As with screen's select command, \*Q-\*U selects the blank window. As a special case for reattach, \*Q=\*U -brings up the windowlist on the blank window. +brings up the windowlist on the blank window. The command will not be +executed if the specified window could not be found. .TP 5 .B \-q Suppress printing of error messages. In combination with \*Q-ls\*U the exit -- cgit v1.2.1 From a83eee72adcd5519d604a6f4bbf21337e3205618 Mon Sep 17 00:00:00 2001 From: Curtis Brown Date: Tue, 16 Feb 2010 14:27:27 -0500 Subject: Update the man-page. The man-page is updated for: mousetrack, defmousetrack, focusminsize, group and layout commands. Closes #28715 on savannah. --- src/doc/screen.1 | 170 ++++++++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 169 insertions(+), 1 deletion(-) (limited to 'src/doc/screen.1') diff --git a/src/doc/screen.1 b/src/doc/screen.1 index b580b45..9da825d 100644 --- a/src/doc/screen.1 +++ b/src/doc/screen.1 @@ -1578,6 +1578,12 @@ Same as the \fBmonitor\fP command except that the default setting for new windows is changed. Initial setting is `off'. .sp .ne 3 +.BR "defmousetrack on" | off +.PP +Same as the \fBmousetrack\fP command except that the default setting for new +windows is changed. Initial setting is `off'. +.sp +.ne 3 .B defnonblock .BR on | off | \fInumsecs .PP @@ -1888,6 +1894,20 @@ region respectively. Useful bindings are (j and k as in vi) Note that \fBk\fP is traditionally bound to the \fIkill\fP command. .sp .ne 3 +.BI "focusminsize [ ( " width "|max|_ ) ( " height "|max|_ ) ]" +.PP +This forces any currently selected region to be automatically +resized at least a certain \fIwidth\fP and \fIheight\fP. All +other surrounding regions will be resized in order to accomodate. +This constraint follows everytime the \*Qfocus\*U command is +used. The \*Qresize\*U command can be used to increase either +dimension of a region, but never below what is set with +\*Qfocusminsize\*U. The underscore `_' is a synonym for +\fBmax\fP. Setting a \fIwidth\fP and \fIheight\fP of `0 0' +(zero zero) will undo any constraints and allow for manual resizing. +Without any parameters, the minimum width and height is shown. +.sp +.ne 3 .BR "gr " [ on | off ] .PP Turn GR charset switching on/off. Whenever screen sees an input @@ -1897,6 +1917,15 @@ default (see also \*Qdefgr\*U) is not to process GR switching because otherwise the ISO88591 charset would not work. .sp .ne 3 +.BI group +.RI [ grouptitle ] +.PP +Change or show the group the current window belongs to. Windows can +be moved around between different groups by specifying the name of +the destination group. Without specifying a group, the title of the +current group is displayed. +.sp +.ne 3 .B hardcopy .RB [ -h ] .RI [ file ] @@ -2118,6 +2147,123 @@ away when you press a key (unless your terminal has a hardware status line). Refer to the commands \*Qmsgwait\*U and \*Qmsgminwait\*U for fine tuning. .sp .ne 3 +.BR "layout new " [\fItitle\fP] +.PP +Create a new layout. The screen will change to one whole region +and be switched to the blank window. From here, you build the +regions and the windows they show as you desire. The new layout +will be numbered with the smallest available integer, starting +with zero. You can optionally give a title to your new layout. +Otherwise, it will have a default title of \*Qlayout\*U. You +can always change the title later by using the command +\fBlayout title\fP. +.sp +.ne 3 +.BR "layout remove " [\fIn|title\fP] +.PP +Remove, or in other words, delete the specified layout. Either +the number or the title can be specified. Without either +specification, \fIscreen\fP will remove the current layout. + +Removing a layout does not affect your set windows or regions. +.sp +.ne 3 +.B layout next +.PP +Switch to the next layout available +.sp +.ne 3 +.B layout prev +.PP +Switch to the previous layout available +.sp +.ne 3 +.BR "layout select " [\fIn|title\fP] +.PP +Select the desired layout. Either the number or the title can +be specified. Without either specification, \fIscreen\fP will +prompt and ask which screen is desired. To see which layouts are +available, use the \fBlayout show\fP command. +.sp +.ne 3 +.B layout show +.PP +List on the message line the number(s) and title(s) of the available +layout(s). The current layout is flagged. +.sp +.ne 3 +.BR "layout title " [\fItitle\fP] +.PP +Change or display the title of the current layout. A string given +will be used to name the layout. Without any options, the current +title and number is displayed on the message line. +.sp +.ne 3 +.BR "layout number " [\fIn\fP] +.PP +Change or display the number of the current layout. An integer given +will be used to number the layout. Without any options, the current +number and title is displayed on the message line. +.sp +.ne 3 +.BR "layout attach " [\fItitle\fP|\fB:last\fP] +.PP +Change or display which layout to reattach back to. The default is +\fB:last\fP, which tells \fIscreen\fP to reattach back to the last +used layout just before detachment. By supplying a title, You can +instruct \fIscreen\fP to reattach to a particular layout regardless +which one was used at the time of detachment. Without any options, +the layout to reattach to will be shown in the message line. +.sp +.ne 3 +.BR "layout save " [\fIn|title\fP] +.PP +Remember the current arrangement of regions. When used, \fIscreen\fP +will remember the arrangement of vertically and horizontally split +regions. This arrangement is restored when a \fIscreen\fP session +is reattached or switched back from a different layout. If the +session ends or the \fIscreen\fP process dies, the layout +arrangements are lost. The \fBlayout dump\fP command should help +in this siutation. If a number +or title is supplied, \fIscreen\fP will remember the arrangement of +that particular layout. Without any options, \fIscreen\fP will +remember the current layout. + +Saving your regions can be done automatically by using the +\fBlayout autosave\fP command. +.sp +.ne 3 +.BR "layout autosave " [\fBon|off\fP] +.PP +Change or display the status of automatcally saving layouts. The +default is \fBon\fP, meaning when \fIscreen\fP is detached or +changed to a different layout, the arrangement of regions and windows +will be remembered at the time of change and restored upon return. +If autosave is set to \fBoff\fP, that arrangement will only be +restored to either to the last manual save, using \fBlayout save\fP, +or to when the layout was first created, to a single region with +a single window. Without either an \fBon\fP or \fBoff\fP, the +current status is displayed on the message line. +.sp +.ne 3 +.BR "layout dump " [\fIfilename\fP] +.PP +Write to a file the order of splits made in the current layout. This +is useful to recreate the order of your regions used in your current +layout. Only the current layout is recorded. While the order of the +regions are recorded, the sizes of those regions and which windows +correspond to which regions are not. If no filename is specified, +the default is \fIlayout-dump\fP, saved in the directory that the +\fIscreen\fP process was started in. If the file already exists, +\fBlayout dump\fP will append to that file. As an example: +.PP +.nf + C-a : layout dump /home/user/.screenrc +.fi +.PP +will save or append the layout to the user's \fI.screenrc\fP file. +.sp +.ne 3 .B license .PP Display the disclaimer page. This is done whenever @@ -2270,6 +2416,18 @@ with an `@' in the window-status display. Monitoring is initially off for all windows. .sp .ne 3 +.BR "mousetrack " [ on | off ] +.PP +This command determines whether +.I screen +will watch for +mouse clicks. When this command is enabled, regions that have +been split in various ways can be selected by pointing to them +with a mouse and left-clicking them. Without specifying \fBon\fP +or \fBoff\fP, the current state is displayed. The default state +is determined by the \*Qdefmousetrack\*U command. +.sp +.ne 3 .BI "msgminwait " sec .PP Defines the time @@ -2589,7 +2747,7 @@ resize min minimize current region height .PP .sp .ne 3 -.B "screen \fP[\fI-opts\fP] [\fIn\fP] [\fIcmd\fP [\fIargs\fP]]" +.B "screen \fP[\fI-opts\fP] [\fIn\fP] [\fIcmd\fP [\fIargs\fP]|\fB//group\fP]" .PP Establish a new window. The flow-control options (\fB\-f\fP, \fB\-fn\fP and \fB\-fa\fP), @@ -2603,6 +2761,9 @@ the window number \fIn\fP is assigned to the newly created window (or, if this number is already in-use, the next available number). If a command is specified after \*Qscreen\*U, this command (with the given arguments) is started in the window; otherwise, a shell is created. +If \fB//group\fP is supplied, a container-type window is created in +which other windows may be created inside it. + Thus, if your \*Q.screenrc\*U contains the lines .sp .nf @@ -3044,6 +3205,7 @@ vice versa. .B windowlist .RB [ -b ] .RB [ -m ] +.RB [ -g ] .br .B windowlist .B string @@ -3056,6 +3218,8 @@ vice versa. Display all windows in a table for visual window selection. The desired window can be selected via the standard movement keys (see the \*Qcopy\*U command) and activated via the return key. +If screen was in a window group, screen will +back out of the group and then display the windows in that group. If the .B -b option is given, screen will switch to the blank window before @@ -3064,6 +3228,10 @@ The .B -m option changes the order of the windows, instead of sorting by window numbers screen uses its internal most-recently-used list. +The +.B -g +option will show the windows inside any groups in that level +and downwards. The table format can be changed with the \fBstring\fP and \fBtitle\fP option, the title is displayed as table heading, while -- cgit v1.2.1 From 42f59cca30ef4e7a390b283ba02a4a015718fb2e Mon Sep 17 00:00:00 2001 From: Sadrul Habib Chowdhury Date: Wed, 24 Feb 2010 02:32:23 -0500 Subject: Typo fixes from Trent W Buck. --- src/doc/screen.1 | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'src/doc/screen.1') diff --git a/src/doc/screen.1 b/src/doc/screen.1 index 9da825d..09ef30d 100644 --- a/src/doc/screen.1 +++ b/src/doc/screen.1 @@ -1898,7 +1898,7 @@ Note that \fBk\fP is traditionally bound to the \fIkill\fP command. .PP This forces any currently selected region to be automatically resized at least a certain \fIwidth\fP and \fIheight\fP. All -other surrounding regions will be resized in order to accomodate. +other surrounding regions will be resized in order to accommodate. This constraint follows everytime the \*Qfocus\*U command is used. The \*Qresize\*U command can be used to increase either dimension of a region, but never below what is set with -- cgit v1.2.1 From fcdce5c6320b37649afb1710fd276fabefa6510e Mon Sep 17 00:00:00 2001 From: Curtis Brown Date: Wed, 24 Feb 2010 02:39:03 -0500 Subject: Man-pages updates for -p, -T, 'stuff' and 'su'. --- src/doc/screen.1 | 18 ++++++++++++------ 1 file changed, 12 insertions(+), 6 deletions(-) (limited to 'src/doc/screen.1') diff --git a/src/doc/screen.1 b/src/doc/screen.1 index 09ef30d..83deb02 100644 --- a/src/doc/screen.1 +++ b/src/doc/screen.1 @@ -288,12 +288,13 @@ emulation (only affects auto-margin terminals without `LP'). This can also be set in your .screenrc by specifying `OP' in a \*Qtermcap\*U command. .TP 5 -.BI "\-p " number_or_name +.BI "\-p " number_or_name|-|=|+ Preselect a window. This is useful when you want to reattach to a specific window or you want to send a command via the \*Q-X\*U option to a specific window. As with screen's select command, \*Q-\*U selects the blank window. As a special case for reattach, \*Q=\*U -brings up the windowlist on the blank window. The command will not be +brings up the windowlist on the blank window, while a \*Q+\*U +will create a new window. The command will not be executed if the specified window could not be found. .TP 5 .B \-q @@ -365,6 +366,10 @@ default [\fItty.host\fP] suffix. sets the title (a.\|k.\|a.) for the default shell or specified program. See also the \*Qshelltitle\*U .screenrc command. .TP 5 +.BI "\-T " term +Set the $TERM enviroment varible using the spcified term as +opposed to the defualt setting of \fBscreen\fP. +.TP 5 .B \-U Run screen in UTF-8 mode. This option tells screen that your terminal sends and understands UTF-8 encoded characters. It also sets the default @@ -2932,21 +2937,22 @@ Select whether you want to see the copyright notice during startup. Default is `on', as you probably noticed. .sp .ne 3 -.B stuff -.I string +.B stuff +.RB [ "\fIstring\fR" ] .PP Stuff the string .I string in the input buffer of the current window. This is like the \*Qpaste\*U command but with much less overhead. +Without a paramter, screen will prompt for a string to stuff. You cannot paste large buffers with the \*Qstuff\*U command. It is most useful for key bindings. See also \*Qbindkey\*U. .sp .ne 3 .B su -.RB [ username " [" password -.RB [ password2 ]] +.RI [ username " [" password +.RI [ password2 ]]] .PP Substitute the user of a display. The command prompts for all parameters that are omitted. If passwords are specified as parameters, they have to be -- cgit v1.2.1 From 8a6abbab0161e6df1cea2ae0033a4c7f4a47f8e9 Mon Sep 17 00:00:00 2001 From: Sadrul Habib Chowdhury Date: Sun, 14 Mar 2010 23:02:37 -0400 Subject: Add special rendition for silence'd windows. The default rendition for silence'd windows in caption/hardstatus or in the windowlist is =u (underline). Closes savannah bug #29205. --- src/doc/screen.1 | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) (limited to 'src/doc/screen.1') diff --git a/src/doc/screen.1 b/src/doc/screen.1 index 83deb02..a250b92 100644 --- a/src/doc/screen.1 +++ b/src/doc/screen.1 @@ -2717,13 +2717,13 @@ Unlinks the screen-exchange file used by the commands \*Qwritebuf\*U and \*Qreadbuf\*U. .sp .ne 3 -.B "rendition bell" | monitor | so +.B "rendition bell" | monitor | silence | so .RB "\fIattr\fR " [ \fIcolor ] .PP Change the way .I screen renders the titles of windows that have monitor or bell flags set in caption or hardstatus or windowlist. See the \*QSTRING ESCAPES\*U chapter for the syntax of the modifiers. -The default for monitor is currently \*Q=b \*U (bold, active colors) and for bell \*Q=ub \*U (underline, bold and active colors). +The default for monitor is currently \*Q=b \*U (bold, active colors), for bell \*Q=ub \*U (underline, bold and active colors), and \*Q=u \*U for silence. .sp .ne 3 .B "reset" -- cgit v1.2.1