1 .\" @(#) mytinfo tconv.1 3.2 92/02/01 public domain, By Ross Ridge
2 .\" $FreeBSD: src/usr.bin/tconv/tconv.1,v 1.10.2.6 2002/06/21 15:29:26 charnier Exp $
11 .Nd convert between termcap, terminfo source and terminfo binary
17 .Op Fl B Op Fl D Ar dir
32 utility converts between the three terminal descriptions,
33 termcap, terminfo source, and terminfo binary,
37 It performs the same functions of
42 It also can be used to generate a terminfo source listing from a terminfo
43 binary, one of the functions of System V's
47 .Bl -tag -width indent
51 Convert from terminfo source.
53 Convert from terminfo binary.
55 Convert to terminfo binary.
57 Convert to terminfo source.
60 If a file is specified, one of
64 must specified and the whole file while be translated.
65 If no file is specified then the input options will only restrict looking
66 for the terminal to be translated in places likely have descriptions
72 environment variable, and in
73 .Pa /usr/share/misc/termcap ,
78 environment variable, and in
79 .Pa /usr/lib/terminfo ) ,
82 will look in all available databases.
89 option will be assumed.
92 option is used, the compiled output will be put in the
93 terminfo database, otherwise standard output is used.
95 You cannot translate from terminfo binary to terminfo binary.
96 Translating from terminfo source to terminfo source is possible,
97 but not of much use in most cases, as
99 fields will be followed and incorporated into the output terminal
104 utility should be able translate all standard termcap parameterized strings
105 terminfo format, but complex strings using GNU's %a code may be
106 too hard to translate.
109 thinks a termcap string is already in terminfo format (if a %p
110 code appears in the string), it won't try to translate it.
111 String capabilities that don't take parameters won't be translated.
113 Termcap options: the following options are available when translating termcap
117 .Bl -tag -width indent
119 Don't supply any defaults for missing capabilities.
121 Include obsolete termcap capabilities.
123 Include GNU capabilities.
125 Include UW capabilities.
129 .Bl -tag -width indent
131 Keep comments when translating a file.
133 Print version information and exit.
135 Directory to put terminfo binaries in.
137 Terminal name to translate.
140 If no terminal specified with the
142 option, then the terminal name to translate will be taken from the
146 .Bl -tag -width /usr/lib/terminfo/terminfo.src -compact
147 .It Pa /usr/lib/terminfo
148 The default location to get and put terminfo binaries.
149 .It Pa /usr/lib/terminfo/terminfo.src
150 The default filename of the terminfo source file.
152 The default filename of the termcap database.
161 The line number of a warning message when translating a file
162 may refer to the last line of an entry instead of the line in the entry
163 that generated the warning.
165 More warning messages could be generated.
168 utility can't translate to termcap. Binaries generated will have canceled
169 capabilities marked as canceled, which is incompatible with
170 System V Release 2.0 terminfo.