168 lines
3.8 KiB
Groff
168 lines
3.8 KiB
Groff
.\" @(#) mytinfo tconv.1 3.2 92/02/01 public domain, By Ross Ridge
|
|
.\" $FreeBSD$
|
|
.\"
|
|
.Dd February 1, 1992
|
|
.Dt TCONV 1
|
|
.Os
|
|
.Sh NAME
|
|
.Nm tconv ,
|
|
.Nm tic ,
|
|
.Nm captoinfo
|
|
.Nd convert between termcap, terminfo source and terminfo binary
|
|
.Sh SYNOPSIS
|
|
.Nm
|
|
.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 ) ,
|
|
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.
|