diff options
Diffstat (limited to 'src/doc/screen.texinfo')
| -rw-r--r-- | src/doc/screen.texinfo | 172 |
1 files changed, 140 insertions, 32 deletions
diff --git a/src/doc/screen.texinfo b/src/doc/screen.texinfo index eb834e4..539f23d 100644 --- a/src/doc/screen.texinfo +++ b/src/doc/screen.texinfo @@ -1142,7 +1142,7 @@ Store a string to a register. @xref{Registers}. Kill current region. @xref{Regions}. @item removebuf Delete the screen-exchange file. @xref{Screen Exchange}. -@item rendition bell | monitor | so @var{attr} [@var{color}] +@item rendition bell | monitor | silence | so @var{attr} [@var{color}] Change text attributes in caption for flagged windows. @xref{Rendition}. @item reset Reset the terminal settings for the window. @xref{Reset}. @@ -1577,9 +1577,7 @@ current window. The latter is useful if used with screen's @deffnx Command windowlist title [@var{title}] (@kbd{C-a "})@* Display all windows in a table for visual window selection. -The desired window can be selected via the standard -movement keys (@pxref{Movement}) and activated via -the return key. If screen was in a window group, screen will +If screen was in a window group, screen will back out of the group and then display the windows in that group. If the @code{-b} option is given, screen will switch to the blank window before presenting the list, so @@ -1589,6 +1587,66 @@ sorting by window numbers screen uses its internal most-recently-used list. The @code{-g} option will show the windows inside any groups in that level and downwards. +The following keys are used to navigate in @code{windowlist}: + +@noindent +@kbd{k}, @kbd{C-p}, or @kbd{up} Move up one line. + +@noindent +@kbd{j}, @kbd{C-n}, or @kbd{down} Move down one line. + +@noindent +@kbd{C-g} or @kbd{escape} Exit windowlist. + +@noindent +@kbd{C-a} or @kbd{home} Move to the first line. + +@noindent +@kbd{C-e} or @kbd{end} Move to the last line. + +@noindent +@kbd{C-u} or @kbd{C-d} Move one half page up or down. + +@noindent +@kbd{C-b} or @kbd{C-f} Move one full page up or down. + +@noindent +@kbd{mouseclick} Move to the selected line. Available when +@code{mousetrack} is set to @code{on}. + +@noindent +@kbd{/} Search. + +@noindent +@kbd{n} Repeat search in the forward direction. + +@noindent +@kbd{N} Repeat search in the backward direction. + +@noindent +@kbd{m} Toggle MRU. + +@noindent +@kbd{g} Toggle group nesting. + +@noindent +@kbd{a} All window view. + +@noindent +@kbd{C-h} or @kbd{backspace} Back out the group. + +@noindent +@kbd{,} Switch numbers with the previous window. + +@noindent +@kbd{.} Switch numbers with the next window. + +@noindent +@kbd{K} Kill that window. + +@noindent +@kbd{space} or @kbd{enter} Select that window. + The table format can be changed with the string and title option, the title is displayed as table heading, while the lines are made by using the string setting. The default @@ -1596,6 +1654,8 @@ setting is @samp{Num Name%=Flags} for the title and @samp{%3n %t%=%f} for the lines. See the string escapes chapter (@pxref{String Escapes}) for more codes (e.g. color settings). +@code{Windowlist} needs a region size of at least 10 characters +wide and 6 characters high in order to display. @end deffn @node Session Management, Regions, Selecting, Top @@ -3479,46 +3539,69 @@ in a single statement. @subsection Movement Keys @noindent -@kbd{h}, @kbd{j}, @kbd{k}, @kbd{l} move the cursor line by line or -column by column. +@kbd{h}, @kbd{C-h}, or @kbd{left arrow} move the cursor left. @noindent -@kbd{0}, @kbd{^} and @kbd{$} move to the leftmost column or to the first -or last non-whitespace character on the line. +@kbd{j}, @kbd{C-n}, or @kbd{down arrow} move the cursor down. @noindent -@kbd{H}, @kbd{M} and @kbd{L} move the cursor to the leftmost column -of the top, center or bottom line of the window. +@kbd{k}, @kbd{C-p}, or @kbd{up arrow} move the cursor up. + +@noindent +@kbd{l} ('el'), or @kbd{right arrow} move the cursor right. + +@noindent +@kbd{0} (zero) or @kbd{C-a} move to the leftmost column. @noindent @kbd{+} and @kbd{-} move the cursor to the leftmost column of the next or previous line. @noindent -@kbd{G} moves to the specified absolute line (default: end of buffer). - +@kbd{H}, @kbd{M} and @kbd{L} move the cursor to the leftmost column +of the top, center or bottom line of the window. + @noindent @kbd{|} moves to the specified absolute column. @noindent -@kbd{w}, @kbd{b}, @kbd{e} move the cursor word by word. +@kbd{g} or @kbd{home} moves to the beginning of the buffer. + +@noindent +@kbd{G} or @kbd{end} moves to the specified absolute line (default: end of buffer). + +@noindent +@kbd{%} jumps to the specified percentage of the buffer. + +@noindent +@kbd{^} or @kbd{$} move to the first +or last non-whitespace character on the line. + +@noindent +@kbd{w}, @kbd{b}, and @kbd{e} move the cursor word by word. @noindent @kbd{B}, @kbd{E} move the cursor WORD by WORD (as in vi). @noindent -@kbd{C-u} and @kbd{C-d} scroll the display up/down by the specified -amount of lines while preserving the cursor position. (Default: half -screenful). +@kbd{f}/@kbd{F}, @kbd{t}/@kbd{T} move the cursor forward/backward to the +next occurence of the target. (eg, '3fy' will move the cursor to the 3rd +'y' to the right.) @noindent -@kbd{C-b} and @kbd{C-f} move the cursor up/down a full screen. +@kbd{;} and @kbd{,} Repeat the last f/F/t/T command in the same/opposite direction. + +@noindent +@kbd{C-e} and @kbd{C-y} scroll the display up/down by one line +while preserving the cursor position. @noindent -@kbd{g} moves to the beginning of the buffer. +@kbd{C-u} and @kbd{C-d} scroll the display up/down by the specified +amount of lines while preserving the cursor position. (Default: half +screenful). @noindent -@kbd{%} jumps to the specified percentage of the buffer. +@kbd{C-b} and @kbd{C-f} move the cursor up/down a full screen. Note that Emacs-style movement keys can be specified by a .screenrc command. (@code{markkeys "h=^B:l=^F:$=^E"}) There is no simple method for @@ -3528,8 +3611,12 @@ a full emacs-style keymap, however, as this involves multi-character codes. @subsection Marking The copy range is specified by setting two marks. The text between these -marks will be highlighted. Press @kbd{space} to set the first or second -mark respectively. +marks will be highlighted. Press: + +@noindent +@kbd{space} or @kbd{enter} to set the first or second mark respectively. +If @code{mousetrack} is set to @code{on}, marks can also be set using +@kbd{left mouse click}. @noindent @kbd{Y} and @kbd{y} can be used to mark one whole line or to mark from @@ -3543,7 +3630,11 @@ start of line. Any command in copy mode can be prefixed with a number (by pressing digits @kbd{0@dots{}9}) which is taken as a repeat count. Example: -@kbd{C-a C-[ H 10 j 5 Y} will copy lines 11 to 15 into the paste buffer. +@example +@kbd{C-a C-[ H 10 j 5 Y} +@end example +@noindent +will copy lines 11 to 15 into the paste buffer. @node Searching, Specials, Repeat count, Copy @subsection Searching @@ -3566,25 +3657,35 @@ Tell screen to ignore the case of characters in searches. Default is @code{off}. @end deffn +@noindent +@kbd{n} Repeat search in forward direction. + +@noindent +@kbd{N} Repeat search in backward direction. + @node Specials, , Searching, Copy @subsection Specials There are, however, some keys that act differently here from in @code{vi}. @code{Vi} does not allow to yank rectangular blocks of text, -but @code{screen} does. Press +but @code{screen} does. Press: @noindent @kbd{c} or @kbd{C} to set the left or right margin respectively. If no repeat count is given, both default to the current cursor position.@* Example: Try this on a rather full text screen: +@example @kbd{C-a [ M 20 l SPACE c 10 l 5 j C SPACE}. +@end example @noindent This moves one to the middle line of the screen, moves in 20 columns left, marks the beginning of the paste buffer, sets the left column, moves 5 columns down, sets the right column, and then marks the end of -the paste buffer. Now try:@* +the paste buffer. Now try: +@example @kbd{C-a [ M 20 l SPACE 10 l 5 j SPACE} +@end example @noindent and notice the difference in the amount of text copied. @@ -3597,11 +3698,11 @@ character with a carriage return character, by issuing a @code{set crlf on}. @noindent -@kbd{v} is for all the @code{vi} users who use @code{:set numbers} - it +@kbd{v} or @kbd{V} is for all the @code{vi} users who use @code{:set numbers} - it toggles the left margin between column 9 and 1. @noindent -@kbd{a} before the final space key turns on append mode. Thus +@kbd{a} before the final @kbd{space} key turns on append mode. Thus the contents of the paste buffer will not be overwritten, but appended to. @noindent @@ -3612,16 +3713,22 @@ the contents of the paste buffer will not be overwritten, but appended to. to the screen-exchange file (@file{/tmp/screen-exchange} per default) once copy-mode is finished. @xref{Screen Exchange}.@* This example demonstrates how to dump the -whole scrollback buffer to that file: @*@kbd{C-a [ g SPACE G $ >}. +whole scrollback buffer to that file: +@example +@kbd{C-a [ g SPACE G $ >}. +@end example @noindent @kbd{C-g} gives information about the current line and column. @noindent -@kbd{x} exchanges the first mark and the current cursor position. You +@kbd{x} or @kbd{o} ('oh') exchanges the first mark and the current cursor position. You can use this to adjust an already placed mark. @noindent +@kbd{C-l} ('el') will redraw the screen. + +@noindent @kbd{@@} does nothing. Absolutely nothing. Does not even exit copy mode. @@ -5145,15 +5252,15 @@ access to your terminal, they will be able to fire off print commands. @node Rendition, Sorendition, Printcmd, Miscellaneous @section Rendition -@deffn Command rendition bell | monitor | so @var{attr} [@var{color}] +@deffn Command rendition bell | monitor | silence | so @var{attr} [@var{color}] (none)@* Change the way screen renders the titles of windows that have monitor or bell flags set in caption or hardstatus or windowlist. See the chapter about string escapes (@pxref{String Escapes}) for the syntax of the modifiers. The default for monitor is currently @samp{=b} (bold, -active colors), and for bell is @samp{=ub} (underline, bold and -active colors). +active colors), for bell @samp{=ub} (underline, bold and active colors), and +for silence @samp{=u}. @end deffn @node Sorendition, Attrcolor, Rendition, Miscellaneous @@ -5604,7 +5711,8 @@ Authors @* ======= Originally created by Oliver Laumann, this latest version was -produced by Wayne Davison, Juergen Weigert and Michael Schroeder. +produced by Juergen Weigert, Michael Schroeder, Micah Cowan and +Sadrul Habib Chowdhury. @noindent Contributors @* |