1 .\" @(#) mytinfo tconv.1 3.2 92/02/01 public domain, By Ross Ridge
2 .\" $Id: tconv.1,v 1.7 1997/02/22 19:57:23 peter Exp $
9 .Nd convert between termcap, terminfo source and terminfo binary
15 .Op Fl B Op Fl D Ar dir
29 converts between the three terminal descriptions,
30 termcap, terminfo source, and terminfo binary,
34 It performs the same functions of
39 It also can be used to generate a terminfo source listing from a terminfo
40 binary, one of the functions of System V's
44 .Bl -tag -width indent
48 Convert from terminfo source.
50 Convert from terminfo binary.
52 Convert to terminfo binary.
54 Convert to terminfo source.
57 If a file is specified, one of
61 must specified and the whole file while be translated.
62 If no file is specified then the input options will only restrict looking
63 for the terminal to be translated in places likely have descriptions
69 environment variable, and in
70 .Pa /usr/share/misc/termcap ,
75 environment variable, and in
76 .Pa /usr/lib/terminfo Ns ),
79 will look in all available databases.
86 option will be assumed.
89 option is used, the compiled output will be put in the
90 terminfo database, otherwise standard output is used.
92 You cannot translate from terminfo binary to terminfo binary.
93 Translating from terminfo source to terminfo source is possible,
94 but not of much use in most cases, as
96 fields will be followed and incorporated into the output terminal
100 should be able translate all standard termcap parameterized strings
101 terminfo format, but complex strings using GNU's %a code may be
102 too hard to translate.
105 thinks a termcap string is already in terminfo format (if a %p
106 code appears in the string), it won't try to translate it.
107 String capabilities that don't take parameters won't be translated.
109 Termcap options: the following options are available when translating termcap
113 .Bl -tag -width indent
115 Don't supply any defaults for missing capabilities.
117 Include obsolete termcap capabilities.
119 Include GNU capabilities.
121 Include UW capabilities.
125 .Bl -tag -width indent
127 Keep comments when translating a file.
129 Print version information and exit.
131 Directory to put terminfo binaries in.
133 Terminal name to translate.
136 If no terminal specified with the
138 option, then the terminal name to to translate will be taken from the
142 .Bl -tag -width /usr/lib/terminfo/terminfo.src -compact
143 .It Pa /usr/lib/terminfo
144 The default location to get and put terminfo binaries.
145 .It Pa /usr/lib/terminfo/terminfo.src
146 The default filename of the terminfo source file.
148 The default filename of the termcap database.
157 The line number of a warning message when translating a file
158 may refer to the last line of an entry instead of the line in the entry
159 that generated the warning.
161 More warning messages could be generated.
163 can't translate to termcap. Binaries generated will have canceled
164 capabilities marked as canceled, which is incompatible with
165 System V Release 2.0 terminfo.