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