captoinfo(1) convert a termcap description into a terminfo description

SYNOPSIS

captoinfo [-vn width] [-V] [-1] [-w width] file . . .

DESCRIPTION

captoinfo looks in each given text file for termcap descriptions. For each one found, an equivalent terminfo description is written to standard output. Termcap tc capabilities are translated directly to terminfo use capabilities.

If no file is given, then the environment variable TERMCAP is used for the filename or entry. If TERMCAP is a full pathname to a file, only the terminal whose name is specified in the environment variable TERM is extracted from that file. If the environment variable TERMCAP is not set, then the file /etc/terminfo is read.

-v
print out tracing information on standard error as the program runs.
-V
print out the version of the program in use on standard error and exit.
-1
cause the fields to print out one to a line. Otherwise, the fields will be printed several to a line to a maximum width of 60 characters.
-w
change the output to width characters.

FILES

/etc/terminfo
Compiled terminal description database.

TRANSLATIONS FROM NONSTANDARD CAPABILITIES

Some obsolete nonstandard capabilities will automatically be translated into standard (SVr4/XSI Curses) terminfo capabilities by captoinfo. Whenever one of these automatic translations is done, the program will issue an notification to stderr, inviting the user to check that it has not mistakenly translated a completely unknown and random capability and/or syntax error.

NonstdStdFromTerminfo
namenamecapability

BOmrAT&Tenter_reverse_mode
CIviAT&Tcursor_invisible
CVveAT&Tcursor_normal
DSmhAT&Tenter_dim_mode
EEmeAT&Texit_attribute_mode
FELFAT&Tlabel_on
FLLOAT&Tlabel_off
XSmkAT&Tenter_secure_mode
EN@7XENIXkey_end
GEaeXENIXexit_alt_charset_mode
GSasXENIXenter_alt_charset_mode
HMkhXENIXkey_home
LDkLXENIXkey_dl
PDkNXENIXkey_npage
PNpoXENIXprtr_off
PSpfXENIXprtr_on
PUkPXENIXkey_ppage
RT@8XENIXkent
UPkuXENIXkcuu1
KAk;Tekkey_f10
KBF1Tekkey_f11
KCF2Tekkey_f12
KDF3Tekkey_f13
KEF4Tekkey_f14
KFF5Tekkey_f15
BCSbTekset_background
FCSfTekset_foreground
HSmhIrisenter_dim_mode

XENIX termcap also used to have a set of extension capabilities for forms drawing, designed to take advantage of the IBM PC high-half graphics. They were as follows:

CapGraphic

G2upper left
G3lower left
G1upper right
G4lower right
GRpointing right
GLpointing left
GUpointing up
GDpointing down
GHhorizontal line
GVvertical line
GCintersection
G6upper left
G7lower left
G5upper right
G8lower right
Grtee pointing right
Grtee pointing left
Gutee pointing up
Gdtee pointing down
Ghhorizontal line
Gvvertical line
Gcintersection
GGacs magic cookie count

If the single-line capabilities occur in an entry, they will automatically be composed into an acsc string. The double-line capabilities and GG are discarded with a warning message.

IBM's AIX has a terminfo facility descended from SVr1 terminfo but incompatible with the SVr4 format. The following AIX extensions are automatically translated:

IBMXSI

kselkslt
kbtabkcbt
font0s0ds
font1s1ds
font2s2ds
font3s3ds

Additionally, the AIX box1 capability will be automatically translated to an acsc string.

Hewlett-Packard's terminfo library supports two nonstandard terminfo capabilities meml (memory lock) and memu (memory unlock). These will be discarded with a warning message.

NOTES

This utility is actually a link to tic(1), running in -I mode. You can use other tic options such as -f and -x.

The trace option is not identical to SVr4's. Under SVr4, instead of following the -v with a trace level n, you repeat it n times.

AUTHOR

Eric S. Raymond <[email protected]> and
Thomas E. Dickey <[email protected]>