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