screen.texinfo (screen-4.8.0) | : | screen.texinfo (screen-4.9.0) | ||
---|---|---|---|---|
\input texinfo @c -*-texinfo-*- | \input texinfo @c -*-texinfo-*- | |||
@c %**start of header | @c %**start of header | |||
@c vi:set wm=5 | @c vi:set wm=5 | |||
@documentencoding ISO-8859-15 | @documentencoding ISO-8859-15 | |||
@setfilename screen.info | @setfilename screen.info | |||
@settitle Screen User's Manual | @settitle Screen User's Manual | |||
@dircategory General Commands | @dircategory General Commands | |||
@finalout | @finalout | |||
@setchapternewpage odd | @setchapternewpage odd | |||
@c %**end of header | @c %**end of header | |||
@set version 4.8.0 | @set version 4.9.0 | |||
@direntry | @direntry | |||
* Screen: (screen). Full-screen window manager. | * Screen: (screen). Full-screen window manager. | |||
@end direntry | @end direntry | |||
@c For examples, use a literal escape in info. | @c For examples, use a literal escape in info. | |||
@ifinfo | @ifinfo | |||
@set esc ^[ | @set esc ^[ | |||
@end ifinfo | @end ifinfo | |||
@iftex | @iftex | |||
@set esc <ESC> | @set esc <ESC> | |||
@end iftex | @end iftex | |||
@ifinfo | @ifinfo | |||
This file documents the @code{Screen} virtual terminal manager. | This file documents the @code{Screen} virtual terminal manager. | |||
Copyright (c) 1993-2018 Free Software Foundation, Inc. | Copyright (c) 1993-2022 Free Software Foundation, Inc. | |||
Permission is granted to make and distribute verbatim copies of | Permission is granted to make and distribute verbatim copies of | |||
this manual provided the copyright notice and this permission notice | this manual provided the copyright notice and this permission notice | |||
are preserved on all copies. | are preserved on all copies. | |||
@ignore | @ignore | |||
Permission is granted to process this file through TeX and print the | Permission is granted to process this file through TeX and print the | |||
results, provided the printed document carries copying permission | results, provided the printed document carries copying permission | |||
notice identical to this one except for the removal of this paragraph | notice identical to this one except for the removal of this paragraph | |||
(this paragraph not being relevant to the printed manual). | (this paragraph not being relevant to the printed manual). | |||
skipping to change at line 56 | skipping to change at line 56 | |||
Permission is granted to copy and distribute translations of this manual | Permission is granted to copy and distribute translations of this manual | |||
into another language, under the above conditions for modified versions, | into another language, under the above conditions for modified versions, | |||
except that this permission notice may be stated in a translation approved | except that this permission notice may be stated in a translation approved | |||
by the Foundation. | by the Foundation. | |||
@end ifinfo | @end ifinfo | |||
@titlepage | @titlepage | |||
@title Screen | @title Screen | |||
@subtitle The virtual terminal manager | @subtitle The virtual terminal manager | |||
@subtitle for Version @value{version} | @subtitle for Version @value{version} | |||
@subtitle Feb 2020 | @subtitle Jan 2022 | |||
@page | @page | |||
@vskip 0pt plus 1filll | @vskip 0pt plus 1filll | |||
Copyright @copyright{} 1993-2018 Free Software Foundation, Inc. | Copyright @copyright{} 1993-2022 Free Software Foundation, Inc. | |||
Permission is granted to make and distribute verbatim copies of | Permission is granted to make and distribute verbatim copies of | |||
this manual provided the copyright notice and this permission notice | this manual provided the copyright notice and this permission notice | |||
are preserved on all copies. | are preserved on all copies. | |||
Permission is granted to copy and distribute modified versions of this | Permission is granted to copy and distribute modified versions of this | |||
manual under the conditions for verbatim copying, provided that the entire | manual under the conditions for verbatim copying, provided that the entire | |||
resulting derived work is distributed under the terms of a permission | resulting derived work is distributed under the terms of a permission | |||
notice identical to this one. | notice identical to this one. | |||
skipping to change at line 506 | skipping to change at line 506 | |||
@cindex screenrc | @cindex screenrc | |||
When @code{screen} is invoked, it executes initialization commands from | When @code{screen} is invoked, it executes initialization commands from | |||
the files @file{.screenrc} in the user's home directory and | the files @file{.screenrc} in the user's home directory and | |||
@file{/usr/local/etc/screenrc}. These defaults can be overridden in the | @file{/usr/local/etc/screenrc}. These defaults can be overridden in the | |||
following ways: | following ways: | |||
For the global screenrc file @code{screen} searches for the environment | For the global screenrc file @code{screen} searches for the environment | |||
variable @code{$SYSSCREENRC} (this override feature may be disabled at | variable @code{$SYSSCREENRC} (this override feature may be disabled at | |||
compile-time). The user specific screenrc file is | compile-time). The user specific screenrc file is | |||
searched for in @code{$SCREENRC}, then | searched for in @code{$SCREENRC}, then | |||
@file{@code{$HOME}/.screenrc}. The command line option @samp{-c} | @file{@code{$HOME}/.screenrc}. The command line option @samp{-c} | |||
specifies which file to use (@pxref{Invoking Screen}. Commands in these | specifies which file to use (@pxref{Invoking Screen}). Commands in these | |||
files are used to set options, bind commands to keys, and to | files are used to set options, bind commands to keys, and to | |||
automatically establish one or more windows at the beginning of | automatically establish one or more windows at the beginning of | |||
your @code{screen} session. Commands are listed one per line, with | your @code{screen} session. Commands are listed one per line, with | |||
empty lines being ignored. A command's arguments are separated by tabs | empty lines being ignored. A command's arguments are separated by tabs | |||
or spaces, and may be surrounded by single or double quotes. A @samp{#} | or spaces, and may be surrounded by single or double quotes. A @samp{#} | |||
turns the rest of the line into a comment, except in quotes. | turns the rest of the line into a comment, except in quotes. | |||
Unintelligible lines are warned about and ignored. Commands may contain | Unintelligible lines are warned about and ignored. Commands may contain | |||
references to environment variables. The syntax is the shell-like | references to environment variables. The syntax is the shell-like | |||
@code{$VAR} or @code{$@{VAR@}}. Note that this causes incompatibility | @code{$VAR} or @code{$@{VAR@}}. Note that this causes incompatibility | |||
with previous @code{screen} versions, as now the '$'-character has to be | with previous @code{screen} versions, as now the '$'-character has to be | |||
skipping to change at line 2212 | skipping to change at line 2212 | |||
resize 20% set current region to 20% of original size | resize 20% set current region to 20% of original size | |||
resize +20% increase current region by 20% | resize +20% increase current region by 20% | |||
resize -b = make all windows equally | resize -b = make all windows equally | |||
resize max maximize current region | resize max maximize current region | |||
resize min minimize current region | resize min minimize current region | |||
@end example | @end example | |||
Without any arguments, @code{screen} will prompt for how you would | Without any arguments, @code{screen} will prompt for how you would | |||
like to resize the current region. | like to resize the current region. | |||
See @code{focusminsize} if you want to restrict the minimun size a region can ha ve. | See @code{focusminsize} if you want to restrict the minimum size a region can ha ve. | |||
@end deffn | @end deffn | |||
@node Caption, Fit, Resize, Regions | @node Caption, Fit, Resize, Regions | |||
@section Caption | @section Caption | |||
@deffn Command caption @code{always}|@code{splitonly} [string] | @deffn Command caption @code{always}|@code{splitonly} [string] | |||
@deffnx Command caption @code{string} [string] | @deffnx Command caption @code{string} [string] | |||
(none)@* | (none)@* | |||
This command controls the display of the window captions. Normally | This command controls the display of the window captions. Normally | |||
a caption is only used if more than one window is shown on the | a caption is only used if more than one window is shown on the | |||
skipping to change at line 3687 | skipping to change at line 3687 | |||
or last non-whitespace character on the line. | or last non-whitespace character on the line. | |||
@noindent | @noindent | |||
@kbd{w}, @kbd{b}, and @kbd{e} move the cursor word by word. | @kbd{w}, @kbd{b}, and @kbd{e} move the cursor word by word. | |||
@noindent | @noindent | |||
@kbd{B}, @kbd{E} move the cursor WORD by WORD (as in vi). | @kbd{B}, @kbd{E} move the cursor WORD by WORD (as in vi). | |||
@noindent | @noindent | |||
@kbd{f}/@kbd{F}, @kbd{t}/@kbd{T} move the cursor forward/backward to the | @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 | next occurrence of the target. (eg, '3fy' will move the cursor to the 3rd | |||
'y' to the right.) | 'y' to the right.) | |||
@noindent | @noindent | |||
@kbd{;} and @kbd{,} Repeat the last f/F/t/T command in the same/opposite directi on. | @kbd{;} and @kbd{,} Repeat the last f/F/t/T command in the same/opposite directi on. | |||
@noindent | @noindent | |||
@kbd{C-e} and @kbd{C-y} scroll the display up/down by one line | @kbd{C-e} and @kbd{C-y} scroll the display up/down by one line | |||
while preserving the cursor position. | while preserving the cursor position. | |||
@noindent | @noindent | |||
skipping to change at line 3868 | skipping to change at line 3868 | |||
argument is specified no current window is needed. When the source specification | argument is specified no current window is needed. When the source specification | |||
only contains registers (not the paste buffer) then there need not be a current | only contains registers (not the paste buffer) then there need not be a current | |||
display (terminal attached), as the registers are a global resource. The | display (terminal attached), as the registers are a global resource. The | |||
paste buffer exists once for every user. | paste buffer exists once for every user. | |||
@end deffn | @end deffn | |||
@deffn Command stuff [string] | @deffn Command stuff [string] | |||
(none)@* | (none)@* | |||
Stuff the string @var{string} in the input buffer of the current window. | Stuff the string @var{string} in the input buffer of the current window. | |||
This is like the @code{paste} command, but with much less overhead. | This is like the @code{paste} command, but with much less overhead. | |||
Without a paramter, @code{screen} will prompt for a string to stuff. | Without a parameter, @code{screen} will prompt for a string to stuff. | |||
You cannot paste large buffers with the @code{stuff} command. It is most | You cannot paste large buffers with the @code{stuff} command. It is most | |||
useful for key bindings. @xref{Bindkey}. | useful for key bindings. @xref{Bindkey}. | |||
@end deffn | @end deffn | |||
@deffn Command pastefont [state] | @deffn Command pastefont [state] | |||
Tell screen to include font information in the paste buffer. The | Tell screen to include font information in the paste buffer. The | |||
default is not to do so. This command is especially useful for | default is not to do so. This command is especially useful for | |||
multi character fonts like kanji. | multi character fonts like kanji. | |||
@end deffn | @end deffn | |||
skipping to change at line 5319 | skipping to change at line 5319 | |||
@node Time, Verbose, Number, Miscellaneous | @node Time, Verbose, Number, Miscellaneous | |||
@section Time | @section Time | |||
@kindex t | @kindex t | |||
@kindex C-t | @kindex C-t | |||
@deffn Command time [@var{string}] | @deffn Command time [@var{string}] | |||
(@kbd{C-a t}, @kbd{C-a C-t})@* | (@kbd{C-a t}, @kbd{C-a C-t})@* | |||
Uses the message line to display the time of day, the host name, and the | Uses the message line to display the time of day, the host name, and the | |||
load averages over 1, 5, and 15 minutes (if this is available on your | load averages over 1, 5, and 15 minutes (if this is available on your | |||
system). For window-specific information use @code{info} (@pxref{Info}). | system). For window-specific information use @code{info} (@pxref{Info}). | |||
If a @var{string} is specified, it changes the format of the time report | If a @var{string} is specified, it changes the format of the time report | |||
like it is described in the string escapes chapter (@pxref{String Escapes}). Scr | like it is described in the string escapes chapter (@pxref{String Escapes}). | |||
een uses a default of @samp{%c:%s %M %d %H%? %l%?}. | Screen uses a default of @samp{%c:%s %M %d %H%? %l%?}. | |||
@end deffn | @end deffn | |||
@node Verbose, Version, Time, Miscellaneous | @node Verbose, Version, Time, Miscellaneous | |||
@section Verbose | @section Verbose | |||
@deffn Command verbose [on|off] | @deffn Command verbose [on|off] | |||
If verbose is switched on, the command name is echoed, whenever a window | If verbose is switched on, the command name is echoed, whenever a window | |||
is created (or resurrected from zombie state). Default is off. | is created (or resurrected from zombie state). Default is off. | |||
Without a parameter, the current setting is shown. | Without a parameter, the current setting is shown. | |||
@end deffn | @end deffn | |||
skipping to change at line 5569 | skipping to change at line 5570 | |||
@item c | @item c | |||
current time @code{HH:MM} in 24h format | current time @code{HH:MM} in 24h format | |||
@item C | @item C | |||
current time @code{HH:MM} in 12h format | current time @code{HH:MM} in 12h format | |||
@item d | @item d | |||
day number | day number | |||
@item D | @item D | |||
weekday name | weekday name | |||
@item E | @item E | |||
sets %? to true if the escape character has been pressed. | sets %? to true if the escape character has been pressed. | |||
@item e | ||||
encoding | ||||
@item f | @item f | |||
flags of the window. @xref{Windows}, for meanings of the various flags. | flags of the window. @xref{Windows}, for meanings of the various flags. | |||
@item F | @item F | |||
sets %? to true if the window has the focus | sets %? to true if the window has the focus | |||
@item h | @item h | |||
hardstatus of the window | hardstatus of the window | |||
@item H | @item H | |||
hostname of the system | hostname of the system | |||
@item l | @item l | |||
current load of the system | current load of the system | |||
skipping to change at line 5985 | skipping to change at line 5988 | |||
@item | @item | |||
A weird imagination is most useful to gain full advantage of all the | A weird imagination is most useful to gain full advantage of all the | |||
features. | features. | |||
@end itemize | @end itemize | |||
@node Reporting Bugs, Availability, Known Bugs, Bugs | @node Reporting Bugs, Availability, Known Bugs, Bugs | |||
@section Reporting Bugs | @section Reporting Bugs | |||
@cindex bug report | @cindex bug report | |||
If you find a bug in @code{Screen}, please send electronic mail to | If you find a bug in @code{Screen}, please send mail to | |||
@w{@samp{screen-devel@@gnu.org}}. Include the version number | @w{@samp{screen-devel@@gnu.org}}. Include the version number | |||
of @code{Screen} which you are using. Also include in your message the | of @code{Screen} which you are using. Also include in your message the | |||
hardware and operating system, the compiler used to compile, a | hardware and operating system, the compiler used to compile, a | |||
description of the bug behavior, and the conditions that triggered the | description of the bug behavior, and the conditions that triggered the | |||
bug. Please recompile @code{screen} with the @samp{-DDEBUG} options | bug. Please recompile @code{screen} with the @samp{-DDEBUG} options | |||
enabled, reproduce the bug, and have a look at the debug output written to | enabled, reproduce the bug, and have a look at the debug output written to | |||
the directory @file{/tmp/debug}. If necessary quote suspect passages from the | the directory @file{/tmp/debug}. If necessary quote suspect passages from the | |||
debug output and show the contents of your @file{config.h} if it matters. | debug output and show the contents of your @file{config.h} if it matters. | |||
@node Availability, , Reporting Bugs, Bugs | @node Availability, , Reporting Bugs, Bugs | |||
End of changes. 11 change blocks. | ||||
11 lines changed or deleted | 13 lines changed or added |