screen-info.patch

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