screen-info.patch

   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 @@
  20  by the Foundation.
  21  @end titlepage
  22
  23 +@ifinfo
  24 +@format
  25 +@dircategory Miscellaneous:
  26 +@direntry
  27 +* screen: (screen).                    Terminal multiplexer
  28 +@end direntry
  29 +@end format
  30 +@end ifinfo
  31 +
  32  @node Top, Overview, (dir), (dir)
  33
  34  @ifinfo
  35 @@ -175,7 +189,7 @@
  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
  44 @@ -304,7 +318,7 @@
  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}]
  53 @@ -356,7 +370,7 @@
  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
  62 @@ -438,7 +452,7 @@
  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
  71 @@ -787,9 +801,9 @@
  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]}
  76 +@item aclgrp @var{usrname} [@var{groupname}]
  77  Inherit permissions granted to a group leader. @xref{Multiuser Session}.
  78 -@item aclumask @var{[users]+/-bits ...}
  79 +@item aclumask [@var{users}]+/-@var{bits} ...
  80  Predefine access to new windows. @xref{Umask}.
  81  @item activity @var{message}
  82  Set the activity notification message.  @xref{Monitor}.
  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 @@
 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}.
 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 @@
 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}.
 173 @@ -889,7 +903,7 @@
 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}.
 182 @@ -905,15 +919,15 @@
 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}.
 201 @@ -921,9 +935,9 @@
 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]}
 206 +@item hardstatus [@var{state}]
 207  Use the hardware status line.  @xref{Hardware Status Line}.
 208 -@item height @var{[lines [cols]]}
 209 +@item height [@var{lines} [@var{cols}]]
 210  Set display height.  @xref{Window Size}.
 211  @item help
 212  Display current key bindings.  @xref{Help}.
 213 @@ -933,9 +947,9 @@
 214  Change the window's hardstatus line.  @xref{Hardstatus}.
 215  @item info
 216  Display window settings.  @xref{Info}.
 217 -@item ins_reg @var{[key]}
 218 +@item ins_reg [@var{key}]
 219  Removed, use @code{paste} instead.  @xref{Registers}.
 220 -@item kanji @var{wtype [dtype]}
 221 +@item kanji @var{wtype} [@var{dtype}]
 222  Set the kanji type of a window.  @xref{Character Processing}.
 223  @item kill
 224  Destroy the current window.  @xref{Kill}.
 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}.
 232  @item logfile @var{filename}
 233  Place where to collect logfiles.  @xref{Log}.
 234 -@item login @var{[state]}
 235 -Log the window in @file{/etc/utmp}.  @xref{Login}.
 236 -@item logtstamp @var{[state]}
 237 +@item login [@var{state}]
 238 +Log the window in @file{/var/run/utmp}.  @xref{Login}.
 239 +@item logtstamp [@var{state}]
 240  Configure logfile time-stamps.  @xref{Log}.
 241  @item mapdefault
 242  Use only the default mapping table for the next keystroke.  @xref{Bindkey Control}.
 243 @@ -963,7 +977,7 @@
 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}.
 252 @@ -977,9 +991,9 @@
 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}.
 264 @@ -987,29 +1001,29 @@
 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]}
 269 +@item password [@var{crypted_pw}]
 270  Set reattach password.  @xref{Detach}.
 271 -@item paste @var{[src_regs [dest_reg]]}
 272 +@item paste [@var{src_regs} [@var{dest_reg}]]
 273  Paste contents of paste buffer or registers somewhere.  @xref{Paste}.
 274 -@item pastefont @var{[state]}
 275 +@item pastefont [@var{state}]
 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]}
 282 +@item pow_detach_msg [@var{message}]
 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]}
 287 +@item printcmd [@var{cmd}]
 288  Set a command for VT100 printer port emulation.  @xref{Printcmd}.
 289 -@item process @var{[key]}
 290 +@item process [@var{key}]
 291  Treat a register as input to @code{screen}.  @xref{Registers}.
 292  @item quit
 293  Kill all windows and exit.  @xref{Quit}.
 294 -@item readbuf @var{[filename]}
 295 +@item readbuf [@var{filename}]
 296  Read the paste buffer from the screen-exchange file.  @xref{Screen-Exchange}.
 297 -@item readreg @var{[reg [file]]}
 298 +@item readreg [@var{reg} [@var{file}]]
 299  Load a register from paste buffer or file.  @xref{Registers}.
 300  @item redisplay
 301  Redisplay the current window.  @xref{Redisplay}.
 302 @@ -1023,21 +1037,21 @@
 303  Reset the terminal settings for the window.  @xref{Reset}.
 304  @item resize [(+/-)lines]
 305  Grow or shrink a region
 306 -@item screen @var{[opts] [n] [cmd [args]]}
 307 +@item screen [@var{opts}] [@var{n}] [@var{cmd} [@var{args}]]
 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]}
 312 +@item select [@var{n}]
 313  Switch to a specified window.  @xref{Selecting}.
 314 -@item sessionname @var{[name]}
 315 +@item sessionname [@var{name}]
 316  Name this session.  @xref{Session Name}.
 317 -@item setenv @var{[var [string]]}
 318 +@item setenv [@var{var} [@var{string}]]
 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]}
 325 +@item silence [@var{state|seconds}]
 326  Monitor a window for inactivity.  @xref{Silence}.
 327  @item silencewait @var{seconds}
 328  Default timeout to trigger an inactivity notify.  @xref{Silence}.
 329 @@ -1045,7 +1059,7 @@
 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}.
 338 @@ -1053,31 +1067,31 @@
 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]]]}
 343 +@item su [@var{username} [@var{password} [@var{password2}]]]
 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]}
 350 +@item termcap @var{term terminal-tweaks} [@var{window-tweaks}]
 351  Tweak termcap entries for best performance.  @xref{Termcap Syntax}.
 352 -@item terminfo @var{term terminal-tweaks [window-tweaks]}
 353 +@item terminfo @var{term terminal-tweaks} [@var{window-tweaks}]
 354  Ditto, for terminfo systems.  @xref{Termcap Syntax}.
 355 -@item termcapinfo @var{term terminal-tweaks [window-tweaks]}
 356 +@item termcapinfo @var{term terminal-tweaks} [@var{window-tweaks}]
 357  Ditto, for both systems.  @xref{Termcap Syntax}.
 358  @item time
 359  Display time and load average.  @xref{Time}.
 360 -@item title @var{[windowtitle]}
 361 +@item title [@var{windowtitle}]
 362  Set the name of the current window.  @xref{Title Command}.
 363 -@item umask @var{[users]+/-bits ...}
 364 +@item umask [@var{users}]+/-@var{bits} ...
 365  Synonym to @code{aclumask}. @xref{Umask}.
 366  @item unsetenv @var{var}
 367  Unset environment variable for new windows.  @xref{Setenv}.
 368 -@item utf8 @var{[state [dstate]]}
 369 +@item utf8 [@var{state} [@var{dstate}]]
 370  Select character encoding of the current window.  @xref{Character Processing}.
 371 -@item vbell @var{[state]}
 372 +@item vbell [@var{state}]
 373  Use visual bell.  @xref{Bell}.
 374 -@item vbell_msg @var{[message]}
 375 +@item vbell_msg [@var{message}]
 376  Set vbell message.  @xref{Bell}.
 377  @item vbellwait @var{sec}
 378  Set delay for vbell message.  @xref{Bell}.
 379 @@ -1085,13 +1099,13 @@
 380  Display @code{screen} version.  @xref{Version}.
 381  @item wall @var{message}
 382  Write a message to all displays.  @xref{Multiuser Session}.
 383 -@item width @var{[cols [lines]]}
 384 +@item width [@var{cols} [@var{lines}]]
 385  Set the width of the window.  @xref{Window Size}.
 386  @item windows
 387  List active windows.  @xref{Windows}.
 388 -@item wrap @var{[state]}
 389 +@item wrap [@var{state}]
 390  Control line-wrap behavior.  @xref{Wrap}.
 391 -@item writebuf @var{[filename]}
 392 +@item writebuf [@var{filename}]
 393  Write paste buffer to screen-exchange file.  @xref{Screen-Exchange}.
 394  @item writelock @var{on|off|auto}
 395  Grant exclusive write permission.  @xref{Multiuser Session}.
 396 @@ -1099,7 +1113,7 @@
 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
 405 @@ -1472,13 +1486,12 @@
 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
 425 @@ -1570,7 +1583,7 @@
 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
 434 @@ -1594,8 +1607,8 @@
 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,
 445 @@ -1642,7 +1655,7 @@
 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
 454 @@ -1660,7 +1673,7 @@
 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
 463 @@ -1756,7 +1769,7 @@
 464
 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 @@
 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
 481 @@ -1975,7 +1988,7 @@
 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.
 490 @@ -2020,7 +2033,7 @@
 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
 499 @@ -3097,7 +3110,7 @@
 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
 508 @@ -3306,7 +3319,7 @@
 509
 510  @node Bindkey, Bindkey Examples, Help, Key Binding
 511  @section Bindkey
 512 -@deffn Command bindkey @var{[opts] [string [cmd args]]}
 513 +@deffn Command bindkey [@var{opts}] [@var{string} [@var{cmd args}]]
 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
 517 @@ -3851,7 +3864,7 @@
 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
 526 @@ -4290,7 +4303,7 @@
 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
 535 @@ -4299,7 +4312,7 @@
 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
 544 @@ -4350,8 +4363,8 @@
 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
 555 @@ -4370,7 +4383,7 @@
 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
 564 @@ -4386,7 +4399,7 @@
 565
 566  @node Sorendition, Attrcolor, Printcmd, Miscellaneous
 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.
 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 @@
 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
 608 @@ -4654,7 +4664,7 @@
 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}
 617 @@ -4757,10 +4767,10 @@
 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
 630 @@ -4841,8 +4851,7 @@
 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
 636 +@file{/tmp/screens} chosen at compile-time. If @code{screen} is installed
 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