]> git.pld-linux.org Git - packages/screen.git/blame - screen-info.patch
- BuildRequires: autoconf
[packages/screen.git] / screen-info.patch
CommitLineData
8ffc42de 1--- screen-3.9.9/doc/screen.texinfo.orig Fri May 25 16:40:02 2001
2+++ screen-3.9.9/doc/screen.texinfo Mon Jun 11 02:40:05 2001
3@@ -8,9 +8,14 @@
4 @c %**end of header
5 @set version 3.9.9
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@@ -72,6 +77,15 @@
bed77180
JR
20 by the Foundation.
21 @end titlepage
22
23+@ifinfo
24+@format
25+@dircategory Miscellaneous:
26+@direntry
9f6079b4 27+* screen: (screen). Terminal multiplexer
bed77180
JR
28+@end direntry
29+@end format
30+@end ifinfo
31+
32 @node Top, Overview, (dir), (dir)
33
34 @ifinfo
8ffc42de 35@@ -175,7 +189,7 @@
c122dd4c 36 variable) who will use it to create the new window. The above example would
37 start the @code{emacs} editor (editing @file{prog.c}) and switch to its window.
38
39-If @file{/etc/utmp} is writable by @code{screen}, an appropriate record
40+If @file{/var/run/utmp} is writable by @code{screen}, an appropriate record
41 will be written to this file for each window, and removed when the
42 window is closed. This is useful for working with @code{talk},
43 @code{script}, @code{shutdown}, @code{rsend}, @code{sccs} and other
8ffc42de 44@@ -304,7 +318,7 @@
c122dd4c 45
46 @item -l
47 @itemx -ln
48-Turn login mode on or off (for @file{/etc/utmp} updating). This option
49+Turn login mode on or off (for @file{/var/run/utmp} updating). This option
50 is equivalent to the @code{deflogin} command (@pxref{Login}).
51
52 @item -ls [@var{match}]
8ffc42de 53@@ -356,7 +370,7 @@
c122dd4c 54 In all other cases @samp{-q} has no effect.
55
56 @item -r [@var{pid.sessionname}]
57-@itemx -r @var{sessionowner/[pid.sessionname]}
58+@itemx -r @var{sessionowner/pid.sessionname}
59 Resume a detached @code{screen} session. No other options (except
60 combinations with @samp{-d} or @samp{-D}) may be specified, though
61 the session name
8ffc42de 62@@ -438,7 +452,7 @@
c122dd4c 63 @cindex screenrc
64 When @code{screen} is invoked, it executes initialization commands from
65 the files @file{.screenrc} in the user's home directory and
66-@file{/usr/local/etc/screenrc}. These defaults can be overridden in the
67+@file{/etc/screenrc}. These defaults can be overridden in the
68 following ways:
69 For the global screenrc file @code{screen} searches for the environment
70 variable @code{$SYSSCREENRC} (this override feature may be disabled at
8ffc42de 71@@ -787,9 +801,9 @@
c122dd4c 72 Change a user's permissions. @xref{Multiuser Session}.
73 @item acldel @var{username}
74 Disallow other user in this session. @xref{Multiuser Session}.
75-@item aclgrp @var{usrname [groupname]}
8ffc42de 76+@item aclgrp @var{usrname} [@var{groupname}]
c122dd4c 77 Inherit permissions granted to a group leader. @xref{Multiuser Session}.
8ffc42de 78-@item aclumask @var{[users]+/-bits ...}
79+@item aclumask [@var{users}]+/-@var{bits} ...
c122dd4c 80 Predefine access to new windows. @xref{Umask}.
81 @item activity @var{message}
82 Set the activity notification message. @xref{Monitor}.
8ffc42de 83@@ -797,37 +811,37 @@
84 Synonym to @code{acladd}. @xref{Multiuser Session}.
85 @item allpartial @var{state}
86 Set all windows to partial refresh. @xref{Redisplay}.
87-@item at @var{[ident][@kbd{#}@var{|}@kbd{*}@var{|}@kbd{%}] command [args]}
88+@item at [@var{ident}][@kbd{#}@var{|}@kbd{*}@var{|}@kbd{%}] @var{command} [@var{args}]
89 Execute a command at other displays or windows. @xref{At}.
90-@item attrcolor @var{attrib [attribute/color-modifier]}
91+@item attrcolor @var{attrib} [@var{attribute/color-modifier}]
92 Map attributes to colors. @xref{Attrcolor}.
93 @item autodetach @var{state}
94 Automatically detach the session on SIGHUP. @xref{Detach}.
95 @item autonuke @var{state}
96 Enable a clear screen to discard unwritten output. @xref{Autonuke}.
97-@item bce @var{[state]}
98+@item bce [@var{state}]
99 Change background color erase. @xref{Character Processing}.
100-@item bell_msg @var{[message]}
101+@item bell_msg [@var{message}]
102 Set the bell notification message. @xref{Bell}.
103-@item bind @var{key [command [args]]}
104+@item bind @var{key} [@var{command} [@var{args}]]
105 Bind a command to a key. @xref{Bind}.
106-@item bindkey @var{[opts] [string [cmd args]]}
107+@item bindkey [@var{opts}] [@var{string} [@var{cmd args}]]
108 Bind a string to a series of keystrokes. @xref{Bindkey}.
109-@item break @var{[duration]}
110+@item break [@var{duration}]
111 Send a break signal to the current window. @xref{Break}.
112-@item breaktype @var{[tcsendbreak | TCSBRK | TIOCSBRK]}
113+@item breaktype [@var{tcsendbreak | TCSBRK | TIOCSBRK}]
114 Specify how to generate breaks. @xref{Break}.
115-@item bufferfile @var{[exchange-file]}
116+@item bufferfile [@var{exchange-file}]
117 Select a file for screen-exchange. @xref{Screen-Exchange}.
118-@item c1 @var{[state]}
119+@item c1 [@var{state}]
120 Change c1 code processing. @xref{Character Processing}.
121-@item caption @var{mode} @var{[string]}
122+@item caption @var{mode} [@var{string}]
123 Change caption mode and string. @xref{Regions}.
124 @item chacl @var{usernames permbits list}
125 Synonym to @code{aclchg}. @xref{Multiuser Session}.
126 @item charset @var{set}
127 Change character set slot designation. @xref{Character Processing}.
128-@item chdir @var{[directory]}
129+@item chdir [@var{directory}]
130 Change the current directory for future windows. @xref{Chdir}.
131 @item clear
132 Clear the window screen. @xref{Clear}.
133@@ -835,13 +849,13 @@
c122dd4c 134 Enter a @code{screen} command. @xref{Colon}.
135 @item command
136 Simulate the screen escape key. @xref{Command Character}.
137-@item compacthist @var{[state]}
138+@item compacthist @var{state}
139 Selects compaction of trailing empty lines. @xref{Scrollback}.
140-@item console @var{[state]}
141+@item console @var{state}
142 Grab or ungrab console output. @xref{Console}.
143 @item copy
144 Enter copy mode. @xref{Copy}.
145-@item copy_reg @var{[key]}
146+@item copy_reg @var{key}
147 Removed. Use @code{paste} instead. @xref{Registers}.
148 @item crlf @var{state}
149 Select line break behavior for copying. @xref{Line Termination}.
8ffc42de 150@@ -851,11 +865,11 @@
151 Select default autonuke behavior. @xref{Autonuke}.
152 @item defbce @var{state}
153 Select background color erase. @xref{Character Processing}.
154-@item defbreaktype @var{[tcsendbreak | TCSBRK | TIOCSBRK]}
155+@item defbreaktype [@var{tcsendbreak | TCSBRK | TIOCSBRK}]
156 Specify the default for generating breaks. @xref{Break}.
157 @item defc1 @var{state}
158 Select default c1 processing behavior. @xref{Character Processing}.
159-@item defcharset @var{[set]}
160+@item defcharset [@var{set}]
161 Change defaul character set slot designation. @xref{Character Processing}.
162 @item defescape @var{xy}
163 Set the default command and @code{meta} characters. @xref{Command Character}.
164@@ -863,7 +877,7 @@
c122dd4c 165 Select default flow control behavior. @xref{Flow}.
166 @item defgr @var{state}
167 Select default GR processing behavior. @xref{Character Processing}.
168-@item defhstatus @var{[status]}
169+@item defhstatus @var{status}
170 Select default window hardstatus line. @xref{Hardstatus}.
171 @item defkanji @var{wtype}
172 Select default GR processing behavior. @xref{Character Processing}.
8ffc42de 173@@ -889,7 +903,7 @@
c122dd4c 174 Set default line-wrapping behavior. @xref{Wrap}.
175 @item defwritelock @var{on|off|auto}
176 Set default writelock behavior. @xref{Multiuser Session}.
177-@item defzombie @var{[keys]}
178+@item defzombie @var{keys}
179 Keep dead windows. @xref{Zombie}.
180 @item detach
181 Disconnect @code{screen} from the terminal. @xref{Detach}.
8ffc42de 182@@ -905,15 +919,15 @@
c122dd4c 183 Display a message on startup. @xref{Startup}.
184 @item escape @var{xy}
185 Set the command and @code{meta} characters. @xref{Command Character}.
186-@item exec @var{[[fdpat] command [args ...]]}
187+@item exec @var{fdpat command args ...}
188 Run a subprocess (filter). @xref{Exec}.
189 @item fit
190 Change window size to current display size. @xref{Window Size}.
191-@item flow @var{[fstate]}
192+@item flow @var{fstate}
193 Set flow control behavior. @xref{Flow}.
194 @item focus
195 Move focus to next region. @xref{Regions}.
196-@item gr @var{[state]}
197+@item gr @var{state}
198 Change GR charset processing. @xref{Character Processing}.
199 @item hardcopy
200 Write out the contents of the current window. @xref{Hardcopy}.
8ffc42de 201@@ -921,9 +935,9 @@
c122dd4c 202 Append to hardcopy files. @xref{Hardcopy}.
203 @item hardcopydir @var{directory}
204 Place, where to dump hardcopy files. @xref{Hardcopy}.
205-@item hardstatus @var{[state]}
8ffc42de 206+@item hardstatus [@var{state}]
c122dd4c 207 Use the hardware status line. @xref{Hardware Status Line}.
8ffc42de 208-@item height @var{[lines [cols]]}
209+@item height [@var{lines} [@var{cols}]]
c122dd4c 210 Set display height. @xref{Window Size}.
211 @item help
212 Display current key bindings. @xref{Help}.
8ffc42de 213@@ -933,9 +947,9 @@
c122dd4c 214 Change the window's hardstatus line. @xref{Hardstatus}.
215 @item info
8ffc42de 216 Display window settings. @xref{Info}.
c122dd4c 217-@item ins_reg @var{[key]}
8ffc42de 218+@item ins_reg [@var{key}]
c122dd4c 219 Removed, use @code{paste} instead. @xref{Registers}.
220-@item kanji @var{wtype [dtype]}
8ffc42de 221+@item kanji @var{wtype} [@var{dtype}]
c122dd4c 222 Set the kanji type of a window. @xref{Character Processing}.
223 @item kill
224 Destroy the current window. @xref{Kill}.
8ffc42de 225@@ -945,13 +959,13 @@
226 Display licensing information. @xref{Startup}.
227 @item lockscreen
228 Lock the controlling terminal. @xref{Lock}.
229-@item log @var{[state]}
230+@item log [@var{state}]
231 Log all output in the current window. @xref{Log}.
c122dd4c 232 @item logfile @var{filename}
233 Place where to collect logfiles. @xref{Log}.
8ffc42de 234-@item login @var{[state]}
c122dd4c 235-Log the window in @file{/etc/utmp}. @xref{Login}.
8ffc42de 236-@item logtstamp @var{[state]}
237+@item login [@var{state}]
c122dd4c 238+Log the window in @file{/var/run/utmp}. @xref{Login}.
8ffc42de 239+@item logtstamp [@var{state}]
c122dd4c 240 Configure logfile time-stamps. @xref{Log}.
241 @item mapdefault
8ffc42de 242 Use only the default mapping table for the next keystroke. @xref{Bindkey Control}.
243@@ -963,7 +977,7 @@
c122dd4c 244 Rebind keys in copy mode. @xref{Copy Mode Keys}.
245 @item meta
246 Insert the command character. @xref{Command Character}.
247-@item monitor @var{[state]}
248+@item monitor @var{state}
249 Monitor activity in window. @xref{Monitor}.
250 @item msgminwait @var{sec}
251 Set minimum message wait. @xref{Message Wait}.
8ffc42de 252@@ -977,9 +991,9 @@
c122dd4c 253 Switch to the next window. @xref{Selecting}.
254 @item nonblock @var{state}
255 Disable flow control to the current display. @xref{Nonblock}.
256-@item number @var{[n]}
257+@item number @var{n}
258 Change/display the current window's number. @xref{Number}.
259-@item obuflimit @var{[limit]}
260+@item obuflimit @var{limit}
261 Select output buffer limit. @xref{Obuflimit}.
262 @item only
263 Kill all other regions. @xref{Regions}.
8ffc42de 264@@ -987,29 +1001,29 @@
c122dd4c 265 Switch to the window you were in last. @xref{Selecting}.
266 @item partial @var{state}
267 Set window to partial refresh. @xref{Redisplay}.
268-@item password @var{[crypted_pw]}
8ffc42de 269+@item password [@var{crypted_pw}]
c122dd4c 270 Set reattach password. @xref{Detach}.
271-@item paste @var{[src_regs [dest_reg]]}
8ffc42de 272+@item paste [@var{src_regs} [@var{dest_reg}]]
c122dd4c 273 Paste contents of paste buffer or registers somewhere. @xref{Paste}.
274-@item pastefont @var{[state]}
8ffc42de 275+@item pastefont [@var{state}]
c122dd4c 276 Include font information in the paste buffer. @xref{Paste}.
277 @item pow_break
278 Close and Reopen the window's terminal. @xref{Break}.
279 @item pow_detach
280 Detach and hang up. @xref{Power Detach}.
281-@item pow_detach_msg @var{[message]}
8ffc42de 282+@item pow_detach_msg [@var{message}]
c122dd4c 283 Set message displayed on @code{pow_detach}. @xref{Power Detach}.
284 @item prev
285 Switch to the previous window. @xref{Selecting}.
286-@item printcmd @var{[cmd]}
8ffc42de 287+@item printcmd [@var{cmd}]
c122dd4c 288 Set a command for VT100 printer port emulation. @xref{Printcmd}.
289-@item process @var{[key]}
8ffc42de 290+@item process [@var{key}]
c122dd4c 291 Treat a register as input to @code{screen}. @xref{Registers}.
292 @item quit
293 Kill all windows and exit. @xref{Quit}.
8ffc42de 294-@item readbuf @var{[filename]}
295+@item readbuf [@var{filename}]
c122dd4c 296 Read the paste buffer from the screen-exchange file. @xref{Screen-Exchange}.
297-@item readreg @var{[reg [file]]}
8ffc42de 298+@item readreg [@var{reg} [@var{file}]]
c122dd4c 299 Load a register from paste buffer or file. @xref{Registers}.
300 @item redisplay
301 Redisplay the current window. @xref{Redisplay}.
8ffc42de 302@@ -1023,21 +1037,21 @@
c122dd4c 303 Reset the terminal settings for the window. @xref{Reset}.
8ffc42de 304 @item resize [(+/-)lines]
305 Grow or shrink a region
c122dd4c 306-@item screen @var{[opts] [n] [cmd [args]]}
8ffc42de 307+@item screen [@var{opts}] [@var{n}] [@var{cmd} [@var{args}]]
c122dd4c 308 Create a new window. @xref{Screen Command}.
309 @item scrollback @var{num}
310 Set size of scrollback buffer. @xref{Scrollback}.
311-@item select @var{[n]}
8ffc42de 312+@item select [@var{n}]
c122dd4c 313 Switch to a specified window. @xref{Selecting}.
314-@item sessionname @var{[name]}
8ffc42de 315+@item sessionname [@var{name}]
c122dd4c 316 Name this session. @xref{Session Name}.
317-@item setenv @var{[var [string]]}
8ffc42de 318+@item setenv [@var{var} [@var{string}]]
c122dd4c 319 Set an environment variable for new windows. @xref{Setenv}.
320 @item shell @var{command}
321 Set the default program for new windows. @xref{Shell}.
322 @item shelltitle @var{title}
323 Set the default name for new windows. @xref{Shell}.
324-@item silence @var{[state|seconds]}
8ffc42de 325+@item silence [@var{state|seconds}]
c122dd4c 326 Monitor a window for inactivity. @xref{Silence}.
327 @item silencewait @var{seconds}
328 Default timeout to trigger an inactivity notify. @xref{Silence}.
8ffc42de 329@@ -1045,7 +1059,7 @@
c122dd4c 330 Pause during startup. @xref{Startup}.
331 @item slowpaste @var{msec}
332 Slow down pasting in windows. @xref{Paste}.
333-@item sorendition @var{[attr [color]]}
334+@item sorendition @var{attr color}
335 Change text highlighting. @xref{Sorendition}.
336 @item split
337 Split region into two parts. @xref{Regions}.
8ffc42de 338@@ -1053,31 +1067,31 @@
c122dd4c 339 Display copyright notice on startup. @xref{Startup}.
340 @item stuff @var{string}
341 Stuff a string in the input buffer of a window. @xref{Paste}.
342-@item su @var{[username [password [password2]]]}
8ffc42de 343+@item su [@var{username} [@var{password} [@var{password2}]]]
c122dd4c 344 Identify a user. @xref{Multiuser Session}.
345 @item suspend
346 Put session in background. @xref{Suspend}.
347 @item term @var{term}
348 Set @code{$TERM} for new windows. @xref{Term}.
349-@item termcap @var{term terminal-tweaks [window-tweaks]}
8ffc42de 350+@item termcap @var{term terminal-tweaks} [@var{window-tweaks}]
c122dd4c 351 Tweak termcap entries for best performance. @xref{Termcap Syntax}.
352-@item terminfo @var{term terminal-tweaks [window-tweaks]}
8ffc42de 353+@item terminfo @var{term terminal-tweaks} [@var{window-tweaks}]
c122dd4c 354 Ditto, for terminfo systems. @xref{Termcap Syntax}.
355-@item termcapinfo @var{term terminal-tweaks [window-tweaks]}
8ffc42de 356+@item termcapinfo @var{term terminal-tweaks} [@var{window-tweaks}]
c122dd4c 357 Ditto, for both systems. @xref{Termcap Syntax}.
358 @item time
359 Display time and load average. @xref{Time}.
360-@item title @var{[windowtitle]}
8ffc42de 361+@item title [@var{windowtitle}]
c122dd4c 362 Set the name of the current window. @xref{Title Command}.
8ffc42de 363-@item umask @var{[users]+/-bits ...}
364+@item umask [@var{users}]+/-@var{bits} ...
c122dd4c 365 Synonym to @code{aclumask}. @xref{Umask}.
366 @item unsetenv @var{var}
367 Unset environment variable for new windows. @xref{Setenv}.
8ffc42de 368-@item utf8 @var{[state [dstate]]}
369+@item utf8 [@var{state} [@var{dstate}]]
370 Select character encoding of the current window. @xref{Character Processing}.
c122dd4c 371-@item vbell @var{[state]}
8ffc42de 372+@item vbell [@var{state}]
c122dd4c 373 Use visual bell. @xref{Bell}.
374-@item vbell_msg @var{[message]}
8ffc42de 375+@item vbell_msg [@var{message}]
c122dd4c 376 Set vbell message. @xref{Bell}.
377 @item vbellwait @var{sec}
378 Set delay for vbell message. @xref{Bell}.
8ffc42de 379@@ -1085,13 +1099,13 @@
c122dd4c 380 Display @code{screen} version. @xref{Version}.
381 @item wall @var{message}
382 Write a message to all displays. @xref{Multiuser Session}.
8ffc42de 383-@item width @var{[cols [lines]]}
384+@item width [@var{cols} [@var{lines}]]
c122dd4c 385 Set the width of the window. @xref{Window Size}.
386 @item windows
387 List active windows. @xref{Windows}.
388-@item wrap @var{[state]}
8ffc42de 389+@item wrap [@var{state}]
c122dd4c 390 Control line-wrap behavior. @xref{Wrap}.
8ffc42de 391-@item writebuf @var{[filename]}
392+@item writebuf [@var{filename}]
c122dd4c 393 Write paste buffer to screen-exchange file. @xref{Screen-Exchange}.
8ffc42de 394 @item writelock @var{on|off|auto}
395 Grant exclusive write permission. @xref{Multiuser Session}.
396@@ -1099,7 +1113,7 @@
c122dd4c 397 Send an XOFF character. @xref{XON/XOFF}.
398 @item xon
399 Send an XON character. @xref{XON/XOFF}.
400-@item zombie @var{[keys]}
401+@item zombie @var{keys}
402 Keep dead windows. @xref{Zombie}.
403 @end table
404
8ffc42de 405@@ -1472,13 +1486,12 @@
c122dd4c 406 @kindex C-x
407 @deffn Command lockscreen
408 (@kbd{C-a x}, @kbd{C-a C-x})@*
409-Call a screenlock program (@file{/local/bin/lck} or @file{/usr/bin/lock}
410-or a builtin, if no other is available). Screen does not accept any
411-command keys until this program terminates. Meanwhile processes in the
412-windows may continue, as the windows are in the detached state.
413-The screenlock program may be changed through the environment variable
414-@code{$LOCKPRG} (which must be set in the shell from which @code{screen}
415-is started) and is executed with the user's uid and gid.
416+Call a screenlock program (@file{/usr/bin/lck} or a builtin, if no other is
417+available). Screen does not accept any command keys until this program
418+terminates. Meanwhile processes in the windows may continue, as the windows
419+are in the detached state. The screenlock program may be changed through the
420+environment variable @code{$LOCKPRG} (which must be set in the shell from
421+which @code{screen} is started) and is executed with the user's uid and gid.
422
423 Warning: When you leave other shells unlocked and have no password set
424 on @code{screen}, the lock is void: One could easily re-attach from an
8ffc42de 425@@ -1570,7 +1583,7 @@
c122dd4c 426
427 @node Aclgrp, Displays, Acldel, Multiuser Session
428 @subsection Aclgrp
429-@deffn Command aclgrp @var{username [groupname]}
430+@deffn Command aclgrp @var{username groupname}
431 (none)@*
432 Creates groups of users that share common access rights. The
433 name of the group is the username of the group leader. Each
8ffc42de 434@@ -1594,8 +1607,8 @@
c122dd4c 435
436 @node Umask, Wall, Displays, Multiuser Session
437 @subsection aclumask
438-@deffn Command aclumask @var{[[users]+bits |[users]-bits .... ]}
439-@deffnx Command umask @var{[[users]+bits |[users]-bits .... ]}
440+@deffn Command aclumask @var{users+bits |users-bits .... }
441+@deffnx Command umask @var{users+bits |users-bits .... }
442 (none)@*
443 This specifies the access other users have to windows that
444 will be created by the caller of the command. @var{Users} may be no,
8ffc42de 445@@ -1642,7 +1655,7 @@
c122dd4c 446
447 @node Su, , Writelock, Multiuser Session
448 @subsection Su
449-@deffn Command su @var{[username [password [password2]]]}
450+@deffn Command su @var{username password password2}
451 (none)@*
452 Substitute the user of a display. The command prompts for
453 all parameters that are omitted. If passwords are specified
8ffc42de 454@@ -1660,7 +1673,7 @@
c122dd4c 455
456 @node Session Name, Suspend, Multiuser Session, Session Management
457 @section Session Name
458-@deffn Command sessionname @var{[name]}
459+@deffn Command sessionname @var{name}
460 (none)@*
461 Rename the current session. Note that for @code{screen -list} the name
462 shows up with the process-id prepended. If the argument @var{name} is
8ffc42de 463@@ -1756,7 +1769,7 @@
c122dd4c 464
8ffc42de 465 @node Resize, Caption, Remove, Regions
466 @section Resize
467-@deffn Command resize @var{[(+/-)lines]}
468+@deffn Command resize [(+/-)@var{lines}]
469 (none)@*
470 Resize the current region. The space will be removed from or added to
471 the region below or if there's not enough space from the region above.
472@@ -1811,7 +1824,7 @@
c122dd4c 473 * Naming Windows:: Control the name of the window
474 * Console:: See the host's console messages
475 * Kill:: Destroy an unwanted window
476-* Login:: Control @file{/etc/utmp} logging
477+* Login:: Control @file{/var/run/utmp} logging
478 * Mode:: Control the file mode of the pty
479 * Monitor:: Watch for activity in a window
480 * Windows:: List the active windows
8ffc42de 481@@ -1975,7 +1988,7 @@
c122dd4c 482
483 @node Console, Kill, Naming Windows, Window Settings
484 @section Console
485-@deffn Command console @var{[state]}
486+@deffn Command console @var{state}
487 (none)@*
488 Grabs or un-grabs the machines console output to a window. When the argument
489 is omitted the current state is displayed.
8ffc42de 490@@ -2020,7 +2033,7 @@
c122dd4c 491 @kindex L
492 @deffn Command login [state]
493 (@kbd{C-a L})@*
494-Adds or removes the entry in @file{/etc/utmp} for the current window.
495+Adds or removes the entry in @file{/var/run/utmp} for the current window.
496 This controls whether or not the window is @dfn{logged in}. In addition
497 to this toggle, it is convenient to have ``log in'' and ``log out''
498 keys. For instance, @code{bind I login on} and @code{bind O
8ffc42de 499@@ -3097,7 +3110,7 @@
c122dd4c 500
501 @node Exec, Using Exec, , Subprocess Execution
502 @section Exec
503-@deffn Command exec @var{[[fdpat] newcommand [args ... ]]}
504+@deffn Command exec @var{fdpat newcommand args ... }
505 (none)@*
506 Run a unix subprocess (specified by an executable path @var{newcommand} and
507 its optional arguments) in the current window. The flow of data between
8ffc42de 508@@ -3306,7 +3319,7 @@
c122dd4c 509
510 @node Bindkey, Bindkey Examples, Help, Key Binding
511 @section Bindkey
512-@deffn Command bindkey @var{[opts] [string [cmd args]]}
8ffc42de 513+@deffn Command bindkey [@var{opts}] [@var{string} [@var{cmd args}]]
c122dd4c 514 (none)@*
515 This command manages screen's input translation tables. Every
516 entry in one of the tables tells screen how to react if a certain
8ffc42de 517@@ -3851,7 +3864,7 @@
c122dd4c 518
519 @node Obuflimit, Character Translation, Autonuke, Termcap
520 @section Obuflimit
521-@deffn Command obuflimit @var{[limit]}
522+@deffn Command obuflimit @var{limit}
523 (none)@*
524 If the output buffer contains more bytes than the specified limit, no
525 more data will be read from the windows. The default value is 256. If
8ffc42de 526@@ -4290,7 +4303,7 @@
c122dd4c 527 @node Number, Silence, Nonblock, Miscellaneous
528 @section Number
529 @kindex N
530-@deffn Command number @var{[n]}
531+@deffn Command number @var{n}
532 (@kbd{C-a N})@*
533 Change the current window's number. If the given number @var{n} is already
534 used by another window, both windows exchange their numbers. If no argument is
8ffc42de 535@@ -4299,7 +4312,7 @@
c122dd4c 536
537 @node Silence, Time, Number, Miscellaneous
538 @section Silence
539-@deffn Command silence @var{[state|sec]}
540+@deffn Command silence @var{state|sec}
541 (none)@*
542 Toggles silence monitoring of windows. When silence is turned on and an
543 affected window is switched into the background, you will receive the
8ffc42de 544@@ -4350,8 +4363,8 @@
c122dd4c 545
546 @node Zombie, Printcmd, Version, Miscellaneous
547 @section Zombie
548-@deffn Command zombie @var{[keys]}
549-@deffnx Command defzombie @var{[keys]}
550+@deffn Command zombie @var{keys}
551+@deffnx Command defzombie @var{keys}
552 (none)@*
553 Per default windows are removed from the window list as soon as the
554 windows process (e.g. shell) exits. When a string of two keys is
8ffc42de 555@@ -4370,7 +4383,7 @@
c122dd4c 556
557 @node Printcmd, Sorendition, Zombie, Miscellaneous
558 @section Printcmd
559-@deffn Command printcmd @var{[cmd]}
560+@deffn Command printcmd @var{cmd}
561 (none)@*
562 If @var{cmd} is not an empty string, screen will not use the terminal
563 capabilities @code{po/pf} for printing if it detects an ansi print
8ffc42de 564@@ -4386,7 +4399,7 @@
c122dd4c 565
8ffc42de 566 @node Sorendition, Attrcolor, Printcmd, Miscellaneous
c122dd4c 567 @section Sorendition
568-@deffn Command sorendition @var{[attr [color]]}
569+@deffn Command sorendition @var{attr color}
570 (none)@*
571 Change the way screen does highlighting for text marking and printing
572 messages.
8ffc42de 573@@ -4398,7 +4411,7 @@
574
575 @node Attrcolor, , Sorendition, Miscellaneous
576 @section Attrcolor
577-@deffn Command attrcolor @var{attrib [attribute/color-modifier]}
578+@deffn Command attrcolor @var{attrib} [@var{attribute/color-modifier}]
579 (none)@*
580 This command can be used to highlight attributes by changing the color of
581 the text. If the attribute
582@@ -4621,22 +4634,19 @@
c122dd4c 583 global initialization files.
584
585 @item @code{$SYSSCREENRC}
586-@itemx /local/etc/screenrc
587+@itemx /etc/screenrc
588 @code{screen} initialization commands
589
590 @item @code{$SCREENRC}
591 @itemx @code{$HOME}/.iscreenrc
592 @itemx @code{$HOME}/.screenrc
593-Read in after /local/etc/screenrc
594+Read in after /etc/screenrc
595
596 @item @code{$SCREENDIR}/S-@var{login}
597
598-@item /local/screens/S-@var{login}
599+@item /tmp/screens/S-@var{login}
600 Socket directories (default)
601
602-@item /usr/tmp/screens/S-@var{login}
603-Alternate socket directories.
604-
605 @item @var{socket directory}/.termcap
606 Written by the @code{dumptermcap} command
607
8ffc42de 608@@ -4654,7 +4664,7 @@
c122dd4c 609 @itemx /etc/termcap
610 Terminal capability databases
611
612-@item /etc/utmp
613+@item /var/run/utmp
614 Login records
615
616 @item @code{$LOCKPRG}
8ffc42de 617@@ -4757,10 +4767,10 @@
c122dd4c 618 in order to be able to
619 correctly change the owner of the tty device file for each window.
620 Special permission may also be required to write the file
621-@file{/etc/utmp}.
622+@file{/var/run/utmp}.
623
624 @item
625-Entries in @file{/etc/utmp} are not removed when @code{screen} is killed
626+Entries in @file{/var/run/utmp} are not removed when @code{screen} is killed
627 with SIGKILL. This will cause some programs (like "w" or "rwho") to
628 advertise that a user is logged on who really isn't.
629
8ffc42de 630@@ -4841,8 +4851,7 @@
c122dd4c 631 @cindex socket directory
632
633 The socket directory defaults either to @file{$HOME/.screen} or simply to
634-@file{/tmp/screens} or preferably to @file{/usr/local/screens} chosen at
635-compile-time. If @code{screen} is installed
8ffc42de 636+@file{/tmp/screens} chosen at compile-time. If @code{screen} is installed
c122dd4c 637 setuid root, then the administrator should compile screen with an
638 adequate (not NFS mounted) @code{SOCKDIR}. If @code{screen} is not
639 running setuid-root, the user can specify any mode 700 directory in the
This page took 0.233311 seconds and 4 git commands to generate.