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