summaryrefslogtreecommitdiff
path: root/doc/screen.texinfo
diff options
context:
space:
mode:
Diffstat (limited to 'doc/screen.texinfo')
-rw-r--r--doc/screen.texinfo41
1 files changed, 27 insertions, 14 deletions
diff --git a/doc/screen.texinfo b/doc/screen.texinfo
index d721647..c6ee63a 100644
--- a/doc/screen.texinfo
+++ b/doc/screen.texinfo
@@ -143,7 +143,8 @@ whole screen session is detached from the user's terminal.
When a program terminates, @code{screen} (per default) kills the window
that contained it. If this window was in the foreground, the display
switches to the previously displayed window; if none are left,
-@code{screen} exits.
+@code{screen} exits. Shells usually distinguish between running as login-shell or sub-shell.
+Screen runs them as sub-shells, unless told otherwise (See @code{shell} .screenrc command).
Everything you type is sent to the program running in the current
window. The only exception to this is the one keystroke that is used to
@@ -154,7 +155,8 @@ Character}) and all the key bindings (@pxref{Key Binding}) can be fully
customized to be anything you like, though they are always two
characters in length.
-@code{Screen} does not understand the prefix @kbd{C-} to mean control.
+@code{Screen} does not understand the prefix @kbd{C-} to mean control, although
+this notation is used in this manual for readability.
Please use the caret notation (@kbd{^A} instead of @kbd{C-a}) as arguments
to e.g. the @code{escape} command or the @code{-e} option. @code{Screen}
will also print out control characters in caret notation.
@@ -417,7 +419,7 @@ For combinations with the
Set the default shell to be @var{program}. By default, @code{screen}
uses the value of the environment variable @code{$SHELL}, or
@file{/bin/sh} if it is not defined. This option is equivalent to the
-@code{shell} command (@pxref{Shell}).
+@code{shell} command (@pxref{Shell}). See also there.
@item -S @var{sessionname}
Set the name of the new session to @var{sessionname}. This option can
@@ -792,7 +794,7 @@ Write out a @file{.termcap} file. @xref{Dump Termcap}.
(help)@*
Show key bindings. @xref{Help}.
-@item @kbd{C-a C-\}
+@item @kbd{C-a \}
(quit)@*
Kill all windows and terminate @code{screen}. @xref{Quit}.
@@ -909,6 +911,8 @@ Synonym to @code{aclchg}. @xref{Multiuser Session}.
Change character set slot designation. @xref{Character Processing}.
@item chdir [@var{directory}]
Change the current directory for future windows. @xref{Chdir}.
+@item cjkwidth
+Treat ambiguous width characters as full/half width. @xref{Character Processing}.
@item clear
Clear the window screen. @xref{Clear}.
@item colon
@@ -1343,10 +1347,12 @@ Unset an environment variable.
Set the command to be used to create a new shell. This overrides the
value of the environment variable @code{$SHELL}. This is useful if
you'd like to run a tty-enhancer which is expecting to execute the
-program specified in @code{$SHELL}. If the command begins with
-a @samp{-} character, the shell will be started as a login-shell.
+program specified in @code{$SHELL}.
+If the command begins with a @samp{-} character, the shell will be started as a
+login-shell. Typical shells do only minimal initialization when not started as a login-shell.
+E.g. Bash will not read your @file{~/.bashrc} unless it is a login-shell.
-@code{defshell} is currently a synonym to the @code{shell} command.
+@code{defshell} is currently a synonym to the @code{shell} .screenrc command.
@end deffn
@deffn Command shelltitle title
@@ -1725,7 +1731,7 @@ password checking.
Mainly the same as @code{detach}, but also sends a HANGUP signal
to the parent process of @code{screen}.@*
@emph{Caution}: This will result in a
-logout if @code{screen} was started from your login shell.
+logout if @code{screen} was started from your login-shell.
@end deffn
@deffn Command pow_detach_msg [message]
@@ -2032,13 +2038,10 @@ being able to do job control.
@node Quit, , Suspend, Session Management
@section Quit
-@kindex C-\
+@kindex \
@deffn Command quit
-(@kbd{C-a C-\})@*
-Kill all windows and terminate @code{screen}. Note that on VT100-style
-terminals the keys @kbd{C-4} and @kbd{C-\} are identical. So be careful
-not to type @kbd{C-a C-4} when selecting window no. 4. Use the empty
-bind command (as in @code{bind "^\"}) to remove a key binding
+(@kbd{C-a \})@*
+Kill all windows and terminate @code{screen}.
(@pxref{Key Binding}).
@end deffn
@@ -3435,6 +3438,7 @@ terminal.
@end deffn
@deffn Command defcharset [set]
+(none)@*
Like the @samp{charset} command except that the default setting for
new windows is changed. Shows current default if called without
argument.
@@ -3447,6 +3451,14 @@ windows is changed. Initial setting is @code{on} if screen was started
with @samp{-U}, otherwise @code{off}.
@end deffn
+@deffn Command cjkwidth [state]
+(none)@*
+Toggle how ambiguoous characters are treated. If cjkwidth is on screen
+interprets them as double (full) width characters. If off then they are seen
+as one cell (half) width characters.
+@end deffn
+
+
@node Copy and Paste, Subprocess Execution, Virtual Terminal, Top
@chapter Copy and Paste
@cindex copy and paste
@@ -5641,6 +5653,7 @@ Alternate user screenrc file.
@item SHELL
Default shell program for opening windows (default @file{/bin/sh}).
+See also @code{shell} .screenrc command.
@item STY
Alternate socket name. If @code{screen} is invoked, and the environment variable