File screen-man-loginshell.diff of Package screen
---
doc/screen.1 | 18 ++++++++++++------
doc/screen.texinfo | 19 ++++++++++++-------
2 files changed, 24 insertions(+), 13 deletions(-)
Index: screen-4.0.3/doc/screen.texinfo
===================================================================
--- screen-4.0.3.orig/doc/screen.texinfo
+++ screen-4.0.3/doc/screen.texinfo
@@ -140,7 +140,8 @@ whole screen session is detached from th
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
@@ -151,7 +152,8 @@ Character}) and all the key bindings (@p
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.
@@ -386,7 +388,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
@@ -1261,10 +1263,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
@@ -1544,7 +1548,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]
@@ -4932,6 +4936,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
Index: screen-4.0.3/doc/screen.1
===================================================================
--- screen-4.0.3.orig/doc/screen.1
+++ screen-4.0.3/doc/screen.1
@@ -59,7 +59,8 @@ session is detached from the user's term
If this window was in the foreground, the display switches to the previous
window; if none are left,
.I screen
-exits.
+exits. Shells usually distinguish between running as login-shell or sub-shell.
+Screen runs them as sub-shells, unless told otherwise (See \*Qshell\*U .screenrc command).
.PP
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 initiate
@@ -70,7 +71,8 @@ The command character and all the key bi
to be anything you like, though they are always two characters in length.
.PP
.I Screen
-does not understand the prefix \*QC-\*U to mean control.
+does not understand the prefix \*QC-\*U to mean control, although this notation is
+used in this manual for readability.
Please use the caret notation (\*Q^A\*U instead of \*QC-a\*U) as arguments
to e.g. the
.I escape
@@ -330,6 +332,7 @@ For combinations with the \fB\-d\fP/\fB\
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.
+See also there.
.TP 5
.BI "\-S " sessionname
When creating a new session, this option can be used to specify a
@@ -1557,7 +1560,7 @@ windows is changed. Initial setting is 1
.ne 3
.BI "defshell " command
.PP
-Synonym to the \fBshell\fP command. See there.
+Synonym to the \fBshell\fP .screenrc command. See there.
.sp
.ne 3
.BR "defsilence on" | off
@@ -2381,7 +2384,7 @@ the parent process of
.IR screen .
CAUTION: This will result in a logout, when
.I screen
-was started from your login shell.
+was started from your login-shell.
.sp
.ne 3
.B pow_detach_msg
@@ -2625,8 +2628,10 @@ only in rare circumstances.
Set the command to be used to create a new shell.
This overrides the value of the environment variable $SHELL.
This is useful if you'd like to run a tty-enhancer which is expecting to
-execute the program specified in $SHELL. If the command begins with
-a '-' character, the shell will be started as a login-shell.
+execute the program specified in $SHELL.
+If the command begins with a '-' 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 \*Q~/.bashrc\*U unless it is a login-shell.
.sp
.ne 3
.B "shelltitle \fItitle\fP"
@@ -4397,6 +4402,7 @@ Alternate socket directory.
Alternate user screenrc file.
.IP SHELL
Default shell program for opening windows (default \*Q/bin/sh\*U).
+See also \*Qshell\*U .screenrc command.
.IP STY
Alternate socket name.
.IP SYSSCREENRC
