aboutsummaryrefslogtreecommitdiff
path: root/safetitle.1
blob: 2d85c57d1007af679e24ec1b9607e8e97d28956f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
.Dd $Mdocdate$
.Dt safetitle 1
.Os
.Sh NAME
.Nm safetitle
.Nd safely set title of terminal window
.Sh SYNOPSIS
.Nm
.Op Fl d
.Ar title
.Sh DESCRIPTION
.Pp
.Nm
sets the title of the current terminal window,
unless the current terminal is recognized as
.Xr wscons 4 .
.Pp
If run within
.Xr screen 1 ,
.Nm
will correctly identify the terminal in which
.Xr screen 1
is run.
.Pp
.Nm
is superstitious about the type of the terminal
because some terminals do not support the control sequences
that modify the title.
Specifically, NetBSD's
.Xr wscons 4
is rendered (almost) unusable when it is sent such control sequences.
.Nm
provides a simple interface to setting the title in terminals that support it,
while leaving terminals that do not support it alone.
.Sh DIAGNOSTICS
.Pp
If you pass the
.Fl d
flag,
.Nm
will warn you if the current terminal type is blacklisted.
.Sh AUTHORS
.Pp
.Nm
is written by John Ankarström
.Aq Mt john (at) ankarstrom.se .
.Sh BUGS
.Pp
.Nm
supports
.Xr screen 1 ,
except if there are more than one terminal attached to the current session.
In that case,
.Nm
will err on the side of caution and regard the terminals as blacklisted.
Thus, the title will not be set.