screen-info.patch

   1 --- ./doc/screen.texinfo.org    Wed Feb 13 11:37:42 2002
   2 +++ ./doc/screen.texinfo        Wed Jun 19 13:35:42 2002
   3 @@ -9,9 +9,14 @@
   4  @c %**end of header
   5  @set version 3.9.11
   6
   7 +@ifinfo
   8 +@format
   9 +@dircategory Shell utilities:
  10  @direntry
  11 -* Screen: (screen).             Full-screen window manager.
  12 +* Screen: (screen).                    Full-screen window manager
  13  @end direntry
  14 ++@end format
  15 +@end ifinfo
  16
  17  @c For examples, use a literal escape in info.
  18  @ifinfo
  19 @@ -176,7 +190,7 @@
  20  variable) who will use it to create the new window.  The above example would
  21  start the @code{emacs} editor (editing @file{prog.c}) and switch to its window.
  22
  23 -If @file{/etc/utmp} is writable by @code{screen}, an appropriate record
  24 +If @file{/var/run/utmp} is writable by @code{screen}, an appropriate record
  25  will be written to this file for each window, and removed when the
  26  window is closed.  This is useful for working with @code{talk},
  27  @code{script}, @code{shutdown}, @code{rsend}, @code{sccs} and other
  28 @@ -442,7 +456,7 @@
  29  @cindex screenrc
  30  When @code{screen} is invoked, it executes initialization commands from
  31  the files @file{.screenrc} in the user's home directory and
  32 -@file{/usr/local/etc/screenrc}.  These defaults can be overridden in the
  33 +@file{/etc/screenrc}.  These defaults can be overridden in the
  34  following ways:
  35  For the global screenrc file @code{screen} searches for the environment
  36  variable @code{$SYSSCREENRC} (this override feature may be disabled at
  37 @@ -953,7 +967,7 @@
  38  Place, where to dump hardcopy files.  @xref{Hardcopy}.
  39  @item hardstatus [@var{state}]
  40  Use the hardware status line.  @xref{Hardware Status Line}.
  41 -@item height [@var{lines} [@var{cols}]]
  42 +@item ns_regheight [@var{lines} [@var{cols}]]
  43  Set display height.  @xref{Window Size}.
  44  @item help [-c @var{class}]
  45  Display current key bindings.  @xref{Help}.
  46 @@ -980,7 +994,7 @@
  47  @item logfile @var{filename}
  48  Place where to collect logfiles.  @xref{Log}.
  49  @item login [@var{state}]
  50 -Log the window in @file{/etc/utmp}.  @xref{Login}.
  51 +Log the window in @file{/var/run/utmp}.  @xref{Login}.
  52  @item logtstamp [@var{state}]
  53  Configure logfile time-stamps.  @xref{Log}.
  54  @item mapdefault
  55 @@ -1531,13 +1545,12 @@
  56  @kindex C-x
  57  @deffn Command lockscreen
  58  (@kbd{C-a x}, @kbd{C-a C-x})@*
  59 -Call a screenlock program (@file{/local/bin/lck} or @file{/usr/bin/lock}
  60 -or a builtin, if no other is available). Screen does not accept any
  61 -command keys until this program terminates. Meanwhile processes in the
  62 -windows may continue, as the windows are in the detached state.
  63 -The screenlock program may be changed through the environment variable
  64 -@code{$LOCKPRG} (which must be set in the shell from which @code{screen}
  65 -is started) and is executed with the user's uid and gid.
  66 +Call a screenlock program (@file{/usr/bin/lck} or a builtin, if no other is
  67 +available). Screen does not accept any command keys until this program
  68 +terminates. Meanwhile processes in the windows may continue, as the windows
  69 +are in the detached state. The screenlock program may be changed through the
  70 +environment variable @code{$LOCKPRG} (which must be set in the shell from
  71 +which @code{screen} is started) and is executed with the user's uid and gid.
  72
  73  Warning: When you leave other shells unlocked and have no password set
  74  on @code{screen}, the lock is void: One could easily re-attach from an
  75 @@ -1870,7 +1883,7 @@
  76  * Naming Windows::             Control the name of the window
  77  * Console::                    See the host's console messages
  78  * Kill::                        Destroy an unwanted window
  79 -* Login::                       Control @file{/etc/utmp} logging
  80 +* Login::                       Control @file{/var/run/utmp} logging
  81  * Mode::                        Control the file mode of the pty
  82  * Monitor::                     Watch for activity in a window
  83  * Windows::                    List the active windows
  84 @@ -2079,7 +2092,7 @@
  85  @kindex L
  86  @deffn Command login [state]
  87  (@kbd{C-a L})@*
  88 -Adds or removes the entry in @file{/etc/utmp} for the current window.
  89 +Adds or removes the entry in @file{/var/run/utmp} for the current window.
  90  This controls whether or not the window is @dfn{logged in}.  In addition
  91  to this toggle, it is convenient to have ``log in'' and ``log out''
  92  keys.  For instance, @code{bind I login on} and @code{bind O
  93 @@ -4813,22 +4826,19 @@
  94  global initialization files.
  95
  96  @item @code{$SYSSCREENRC}
  97 -@itemx /local/etc/screenrc
  98 +@itemx /etc/screenrc
  99  @code{screen} initialization commands
 100
 101  @item @code{$SCREENRC}
 102  @itemx @code{$HOME}/.iscreenrc
 103  @itemx @code{$HOME}/.screenrc
 104 -Read in after /local/etc/screenrc
 105 +Read in after /etc/screenrc
 106
 107  @item @code{$SCREENDIR}/S-@var{login}
 108
 109 -@item /local/screens/S-@var{login}
 110 +@item /tmp/screens/S-@var{login}
 111  Socket directories (default)
 112
 113 -@item /usr/tmp/screens/S-@var{login}
 114 -Alternate socket directories.
 115 -
 116  @item @var{socket directory}/.termcap
 117  Written by the @code{dumptermcap} command
 118
 119 @@ -4846,7 +4856,7 @@
 120  @itemx /etc/termcap
 121  Terminal capability databases
 122
 123 -@item /etc/utmp
 124 +@item /var/run/utmp
 125  Login records
 126
 127  @item @code{$LOCKPRG}
 128 @@ -4951,10 +4961,10 @@
 129  in order to be able to
 130  correctly change the owner of the tty device file for each window.
 131  Special permission may also be required to write the file
 132 -@file{/etc/utmp}.
 133 +@file{/var/run/utmp}.
 134
 135  @item
 136 -Entries in @file{/etc/utmp} are not removed when @code{screen} is killed
 137 +Entries in @file{/var/run/utmp} are not removed when @code{screen} is killed
 138  with SIGKILL.  This will cause some programs (like "w" or "rwho") to
 139  advertise that a user is logged on who really isn't.
 140
 141 @@ -5035,8 +5045,7 @@
 142  @cindex socket directory
 143
 144  The socket directory defaults either to @file{$HOME/.screen} or simply to
 145 -@file{/tmp/screens} or preferably to @file{/usr/local/screens} chosen at
 146 -compile-time. If @code{screen} is installed
 147 +@file{/tmp/screens} chosen at compile-time. If @code{screen} is installed
 148  setuid root, then the administrator should compile screen with an
 149  adequate (not NFS mounted) @code{SOCKDIR}. If @code{screen} is not
 150  running setuid-root, the user can specify any mode 700 directory in the