← Back to branch summary

~ubuntu-branches/debian/stretch/screen/stretch

« back to all changes in this revision

Viewing changes to doc/screen.1

  • Committer: Package Import Robot
  • Author(s): Axel Beckert
  • Date: 2015-06-17 21:57:18 UTC
  • mfrom: (7.1.5 experimental)
  • Revision ID: package-import@ubuntu.com-20150617215718-mmj4dpghyl5a0ipy
Tags: 4.3.0-2
https://launchpad.net/bugs/1462692
* Upload to unstable again.
* Re-add debian/dirs with /etc/tmpfiles.d/ and add a comment why screen
  ships an empty directory.
  + Fixes regression introduced in 4.2.1-4: If systemd is not installed
    and screen is either setuid or neither setuid nor setgid,
    /var/lib/dpkg/info/screen.postinst bailed out with "16:
    /var/lib/dpkg/info/screen.postinst: cannot create
    /etc/tmpfiles.d/screen-cleanup.conf: Directory nonexistent".
  + See comment in debian/dirs for more detailed reasoning.
* No more ship /lib/systemd/system/screen-cleanup.service in the package
  but link it to /dev/null in postinst and remove the link again in
  postrm. (LP: #1462692)
* Add fixed bugs reported in Ubuntu to previous changelog entry.
* Apply wrap-and-sort.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/screen.1
1
1
.\" vi:set wm=5
2
 
.TH SCREEN 1 "Aug 2003"
 
2
.TH SCREEN 1 "May 2015"
3
3
.if n .ds Q \&"
4
4
.if n .ds U \&"
5
5
.if t .ds Q ``
342
342
sessions in another user's directory. This requires setuid-root.
343
343
.TP 5
344
344
.B \-R
 
345
resumes screen only when it's unambiguous which one to attach, usually
 
346
when only one
 
347
.I screen
 
348
is detached. Otherwise lists available sessions.
 
349
.B \-RR
345
350
attempts to resume the youngest (in terms of creation time) detached
346
351
.I screen
347
352
session it finds.  If successful, all other command-line options are ignored.
405
410
\fB-r\fP option to tell screen to look only for attached or
406
411
detached screen sessions. Note that this command doesn't work if
407
412
the session is password protected.
 
413
 
408
414
.TP 5
409
415
.B \-4
410
416
Resolve hostnames only to IPv4 addresses.
411
417
.TP 5
412
418
.B \-6
413
419
Resolve hostnames only to IPv6 addresses.
414
 
 
415
420
.SH "DEFAULT KEY BINDINGS"
416
421
.ta 12n 26n
417
422
As mentioned, each
1164
1169
.fi
1165
1170
.sp
1166
1171
.ne 3
 
1172
.BR bumpleft
 
1173
.PP
 
1174
Swaps window with previous one on window list.
 
1175
.sp
 
1176
.ne 3
 
1177
.BR bumpright
 
1178
.PP
 
1179
Swaps window with next one on window list.
 
1180
.sp
 
1181
.ne 3
1167
1182
.BR "c1 " [ on | off ]
1168
1183
.PP
1169
1184
Change c1 code processing. \*QC1 on\*U tells screen to treat
1243
1258
Clears the current window and saves its image to the scrollback buffer.
1244
1259
.sp
1245
1260
.ne 3
 
1261
.B collapse
 
1262
.PP
 
1263
Reorders window on window list, removing number gaps between them.
 
1264
.sp
 
1265
.ne 3
1246
1266
.B colon
1247
1267
.RI [ prefix ]
1248
1268
.PP
2087
2107
.ne 3
2088
2108
.BR "hardstatus " [ on | off ]
2089
2109
.br
2090
 
.BR "hardstatus \fR[\fBalways\fR]\fBlastline" | message | ignore
 
2110
.BR "hardstatus \fR[\fBalways\fR]\fBfirstline" | lastline | message | ignore
2091
2111
.RI [ string ]
2092
2112
.br
2093
2113
.B "hardstatus string"
2106
2126
.I screen 
2107
2127
what to do if the terminal doesn't
2108
2128
have a hardstatus line (i.e. the termcap/terminfo capabilities
2109
 
"hs", "ts", "fs" and "ds" are not set). If the type
2110
 
\*Qlastline\*U is used, 
 
2129
"hs", "ts", "fs" and "ds" are not set).
 
2130
When \*Qfirstline/lastline\*U is used, 
2111
2131
.I screen 
2112
 
will reserve the last line of the
2113
 
display for
 
2132
will reserve the first/last line of the display for
2114
2133
the hardstatus. \*Qmessage\*U uses 
2115
2134
.I screen's
2116
2135
message mechanism and
3030
3049
text. 
3031
3050
.sp
3032
3051
.ne 3
 
3052
.B sort
 
3053
.PP
 
3054
Sort the windows in alphabetical order of the window tiles.
 
3055
.sp
 
3056
.ne 3
3033
3057
.BI "source " file
3034
3058
.PP
3035
3059
Read and execute commands from file \fIfile\fP. Source commands may
3443
3467
and 6 characters high in order to display.
3444
3468
.sp
3445
3469
.ne 3
3446
 
.B windows
 
3470
.B windows [ string ]
3447
3471
.PP
3448
3472
Uses the message line to display a list of all the windows.
3449
3473
Each window is listed by number with the name of process that has been
3459
3483
windows in the zombie state are marked with `Z'.
3460
3484
If this list is too long to fit on the terminal's status line only the
3461
3485
portion around the current window is displayed.
 
3486
The optional string parameter follows the \*QSTRING ESCAPES\*U format.
 
3487
If string parameter is passed, the output size is unlimited.
 
3488
The default command without any parameter is limited to a size of 1024 bytes.
3462
3489
.sp
3463
3490
.ne 3
3464
3491
.BR "wrap " [ on | off ]
3555
3582
to monitor exit status of the process running in the window. If it exits normally ('0'), 
3556
3583
the window disappears. Any other exit value causes the window to become a zombie.
3557
3584
 
 
3585
.BR "zombie_timeout" [\fIseconds\fP]
 
3586
.PP
 
3587
Per default
 
3588
.I screen
 
3589
windows are removed from the window list as soon as
 
3590
the windows process (e.g. shell) exits. If \fBzombie\fP keys are defined
 
3591
(compare with above \fBzombie\fP command), it is possible to also set a
 
3592
timeout when screen tries to automatically reconnect a dead screen window.
 
3593
 
3558
3594
.SH "THE MESSAGE LINE"
3559
3595
.I Screen
3560
3596
displays informational messages and other diagnostics in a \fImessage line\fP.
3746
3782
one.
3747
3783
.IP W
3748
3784
all window numbers and names except the current one
 
3785
.IP x
 
3786
the executed command including arguments running in this windows
 
3787
.IP X
 
3788
the executed command without arguments running in this windows
3749
3789
.IP y
3750
3790
last two digits of the year number
3751
3791
.IP Y
4902
4942
 
4903
4943
 
4904
4944
.SH AUTHORS
4905
 
Originally created by Oliver Laumann, this latest version was
4906
 
produced by Juergen Weigert, Michael Schroeder, Micah Cowan and
4907
 
Sadrul Habib Chowdhury.
 
4945
Originally created by Oliver Laumann. For a long time maintained
 
4946
and developed by Juergen Weigert, Michael Schroeder, Micah Cowan
 
4947
and Sadrul Habib Chowdhury. This latest version was produced by
 
4948
Amadeusz Sławiński <amade@asmblr.net>
 
4949
and Alexander Naumov <alexander_naumov@opensuse.org>.
4908
4950
 
4909
4951
.SH COPYLEFT
4910
4952
.nf
4911
 
Copyright (c) 2010
 
4953
Copyright (c) 2010-2015
4912
4954
        Juergen Weigert (jnweiger@immd4.informatik.uni\-erlangen.de)
4913
4955
        Sadrul Habib Chowdhury (sadrul@users.sourceforge.net)
4914
4956
Copyright (c) 2008, 2009
4970
5012
 
4971
5013
 
4972
5014
.SH VERSION
4973
 
This is version 4.1.0. Its roots are a merge of a custom version
 
5015
This is version 4.3.0. Its roots are a merge of a custom version
4974
5016
2.3PR7 by Wayne Davison
4975
5017
and several enhancements to Oliver Laumann's version 2.0. Note that all versions
4976
5018
numbered 2.x are copyright by Oliver Laumann. 
4978
5020
.SH AVAILABILITY
4979
5021
The latest official release of 
4980
5022
.I screen
4981
 
available via anonymous ftp from gnudist.gnu.org, nic.funet.fi or any other 
 
5023
available via anonymous ftp from ftp.gnu.org/gnu/screen/ or any other 
4982
5024
.I GNU 
4983
5025
distribution site. The home site of
4984
5026
.I screen
4985
 
is ftp.uni\-erlangen.de, in the directory
4986
 
pub/utilities/screen. The subdirectory `private' contains the latest beta
4987
 
testing release. If you want to help, send a note to
4988
 
screen@uni\-erlangen.de.
 
5027
is savannah.gnu.org/projects/screen/. If you want to help, send a note to
 
5028
screen-devel@gnu.org.
4989
5029
 
4990
5030
.SH BUGS
4991
5031
.PD
5047
5087
A weird imagination is most useful to gain full advantage of all the features.
5048
5088
.IP \(bu
5049
5089
Send bug-reports, fixes, enhancements, t-shirts, money, beer & pizza to
5050
 
.BR screen@uni\-erlangen.de .
 
5090
.BR screen-devel@gnu.org .
5051
5091