captoinfo.1m - Man Page

convert a termcap description into a terminfo description

Synopsis

captoinfo [tic-option] [file ...]

captoinfo -V

Description

captoinfo translates terminal descriptions. It looks in each given text file for termcap entries and, for each one found, writes an equivalent terminfo description to the standard output stream. termcap tc capabilities translate to terminfouse” capabilities.

If no files are specified, captoinfo interprets the content of the environment variable TERMCAP as a file name, and extracts only the entry for the terminal named in the environment variable TERM from it. If the environment variable TERMCAP is not set, captoinfo reads /etc/termcap.

This utility is implemented as a link to tic(1M), with the latter's -I option implied. You can use other tic options such as -1, -f, -v, -w, and -x. The -V option reports the version of ncurses associated with this program and exits with a successful status.

Translations from Nonstandard Capabilities

captoinfo translates some obsolete, nonstandard capabilities into standard (SVr4/XSI Curses) terminfo capabilities. It issues a diagnostic to the standard error stream for each, inviting the user to check that it has not mistakenly translated an unknown or mistyped capability name.

Name
ObsoleteStandardOriginterminfo capability
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;Tektronixkey_f10
KBF1Tektronixkey_f11
KCF2Tektronixkey_f12
KDF3Tektronixkey_f13
KEF4Tektronixkey_f14
KFF5Tektronixkey_f15
BCSbTektronixset_background
FCSfTektronixset_foreground
HSmhIRIXenter_dim_mode

XENIX termcap had a set of extension capabilities, corresponding to box drawing characters of CCSID (“code page”) 437, as follows.

termcap NameGraphic
G2upper left corner
G3lower left corner
G1upper right corner
G4lower right corner
GRtee pointing right
GLtee pointing left
GUtee pointing up
GDtee pointing down
GHhorizontal line
GVvertical line
GCintersection
G6double upper left corner
G7double lower left corner
G5double upper right corner
G8double lower right corner
Grdouble tee pointing right
Grdouble tee pointing left
Gudouble tee pointing up
Gddouble tee pointing down
Ghdouble horizontal line
Gvdouble vertical line
Gcdouble intersection
GGACS magic cookie count

captoinfo composes single-line capabilities into an acsc string, and discards GG and double-line capabilities with a warning diagnostic.

IBM's AIX has a terminfo facility descended from SVr1 terminfo, but which is incompatible with the SVr4 format. captoinfo translates the following AIX extensions.

IBMXSI
kselkslt
kbtabkcbt
font0s0ds
font1s1ds
font2s2ds
font3s3ds

Additionally, this program translates the AIX box1 capability to an acsc string.

The HP-UX terminfo library supports two nonstandard terminfo capabilities, meml (memory lock) and memu (memory unlock). captoinfo discards these with a warning message.

Files

/etc/termcap

default termcap terminal capability database

Portability

X/Open Curses, Issue 7 (2009) describes tic briefly, but omits this program.

SVr4 systems provide captoinfo as a separate application from tic. Its -v option does not accept a trace level argument n; repeat -v n times instead.

NetBSD does not provide this application.

Authors

Eric S. Raymond <esr@snark.thyrsus.com> and
Thomas E. Dickey <dickey@invisible-island.net>

See Also

infocmp(1M), tic(1M), curses(3X), terminfo(5)

Referenced By

screen(1).

2024-03-23 ncurses 6.5 User commands