blob: d8fa0e48f0701cfc54d0b1c278fe071af138a6fd (
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
|
.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 type is blacklisted.
By default, the single blacklisted terminal is NetBSD's
.Xr wscons 4 .
.Pp
If run within
.Xr screen 1 ,
.Nm
will correctly identify the terminal in which
.Xr screen 1
is run.
If there are multiple terminals attached to the same
.Xr screen 1
session,
.Nm
will ensure that none of them are blacklisted.
.Pp
The reason why
.Nm
is superstitious about the type of the terminal is
that some terminals do not support the control sequences
that modify the title.
Specifically, NetBSD's
.Xr wscons 4
is rendered (nearly) 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 .
|