summaryrefslogtreecommitdiffstats
path: root/usr.bin/tconv/tconv.1
blob: b3f27a2bef59577e82432a98fc0288e8c5c9a1e1 (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
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
.\" @(#) mytinfo tconv.1 3.2 92/02/01 public domain, By Ross Ridge
.\" $Id: tconv.1,v 1.7 1997/02/22 19:57:23 peter Exp $
.\"
.Dd February 1, 1992
.Dt TCONV 1
.Os
.Sh NAME
.Nm tconv
.Nd convert between termcap, terminfo source and terminfo binary
.Sh SYNOPSIS
.Nm tconv
.Op Fl b
.Op Fl c Op Fl OUGd
.Op Fl i
.Op Fl B Op Fl D Ar dir
.Op Fl I
.Op Fl k
.Op Fl V
.Op Fl t Ar term
.Op Ar file
.Nm tic
.Op Ar file
.Nm captoinfo
.Op Fl t Ar term
.Op Fl OUGdk
.Op Ar file
.Sh DESCRIPTION
.Nm Tconv
converts between the three terminal descriptions,
termcap, terminfo source, and terminfo binary,
that the
.Em tinfo
library uses.
It performs the same functions of
.Xr captoinfo 1
and 
.Xr tic 1
of System V.
It also can be used to generate a terminfo source listing from a terminfo
binary, one of the functions of System V's
.Xr infocmp 1 .
.Pp
Translation options:
.Bl -tag -width indent
.It Fl c
Convert from termcap.
.It Fl i
Convert from terminfo source.
.It Fl b
Convert from terminfo binary.
.It Fl B
Convert to terminfo binary.
.It Fl I
Convert to terminfo source.
.El
.Pp
If a file is specified, one of
.Fl c
or
.Fl i
must specified and the whole file while be translated.
If no file is specified then the input options will only restrict looking
for the terminal to be translated in places likely have descriptions
of the desired type
(ie. with the
.Fl c
option in the
.Ev TERMCAP
environment variable, and in
.Pa /usr/share/misc/termcap ,
with the
.Fl i
option in the
.Ev TERMINFO
environment variable, and in
.Pa /usr/lib/terminfo Ns ),
otherwise
.Nm
will look in all available databases.
If neither 
.Fl I
or
.Fl B
are given the
.Fl I
option will be assumed.
If the 
.Fl B
option is used, the compiled output will be put in the
terminfo database, otherwise standard output is used.
.Pp
You cannot translate from terminfo binary to terminfo binary.
Translating from terminfo source to terminfo source is possible, 
but not of much use in most cases, as 
.Em use=
fields will be followed and incorporated into the output terminal
description. 
.Pp
.Nm Tconv
should be able translate all standard termcap parameterized strings
terminfo format, but complex strings using GNU's %a code may be
too hard to translate.
If
.Nm
thinks a termcap string is already in terminfo format (if a %p
code appears in the string), it won't try to translate it.
String capabilities that don't take parameters won't be translated.
.Pp
Termcap options: the following options are available when translating termcap
entries (
.Fl c
option is used).
.Bl -tag -width indent
.It Fl d
Don't supply any defaults for missing capabilities.
.It Fl O
Include obsolete termcap capabilities.
.It Fl G
Include GNU capabilities.
.It Fl U
Include UW capabilities.
.El
.Pp
Other options:
.Bl -tag -width indent
.It Fl k
Keep comments when translating a file.
.It Fl V
Print version information and exit.
.It Fl D Ar dir
Directory to put terminfo binaries in.
.It Fl t Ar term
Terminal name to translate.
.El
.Pp
If no terminal specified with the
.Fl t
option, then the terminal name to to translate will be taken from the
environment variable
.Ev TERM .
.Sh FILES
.Bl -tag -width /usr/lib/terminfo/terminfo.src -compact
.It Pa /usr/lib/terminfo
The default location to get and put terminfo binaries.
.It Pa /usr/lib/terminfo/terminfo.src
The default filename of the terminfo source file.
.It Pa /etc/termcap
The default filename of the termcap database.
.El
.Sh SEE ALSO
.Xr curses 3 ,
.Xr termcap 3 ,
.Xr term 5 ,
.Xr termcap 5 ,
.Xr terminfo 5 .
.Sh DIAGNOSTICS
The line number of a warning message when translating a file
may refer to the last line of an entry instead of the line in the entry 
that generated the warning.
.Sh BUGS
More warning messages could be generated.
.Nm Tconv
can't translate to termcap.  Binaries generated will have canceled
capabilities marked as canceled, which is incompatible with
System V Release 2.0 terminfo.
OpenPOWER on IntegriCloud