screen/screen-man-loginshell.diff

---
 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