captoinfo - convert a termcap description
into a terminfo description
captoinfo [tic-option] [file
. . .]
captoinfo -V
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 terminfo use
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 type 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(1),
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.
captoinfo translates some obsolete, nonstandard
capabilities into standard 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.
TABLE
XENIX termcap had a set of extension capabilities,
corresponding to box drawing characters of CCSID (code page) 437, as
follows.
| f(BItermcapfP Code | Graphic |
|---|---|
| G2 | upper left corner |
| G3 | lower left corner |
| G1 | upper right corner |
| G4 | lower right corner |
| GR | tee pointing right |
| GL | tee pointing left |
| GU | tee pointing up |
| GD | tee pointing down |
| GH | horizontal line |
| GV | vertical line |
| GC | intersection |
| G6 | double upper left corner |
| G7 | double lower left corner |
| G5 | double upper right corner |
| G8 | double lower right corner |
| Gr | double tee pointing right |
| Gr | double tee pointing left |
| Gu | double tee pointing up |
| Gd | double tee pointing down |
| Gh | double horizontal line |
| Gv | double vertical line |
| Gc | double intersection |
| GG | ACS magic cookie count |
captoinfo composes single-line box-drawing
capabilities into a terminfo acs_chars
(acsc) string capability, and discards
GG and double-line capabilities with a warning
diagnostic.
AIX has a terminfo facility descended from SVr2
terminfo, but which is incompatible with the SVr4 format.
captoinfo translates the following AIX extensions.
| IBM | X/Open |
|---|---|
| ksel | kslt |
| kbtab | kcbt |
| font0 | s0ds |
| font1 | s1ds |
| font2 | s2ds |
| font3 | s3ds |
It furthermore translates the AIX box1 capability to an acs_chars (acsc) string capability.
The HP-UX terminfo library supports two nonstandard
terminfo capabilities: memory_lock
(meml) and memory_unlock
(memu). captoinfo discards these with
a warning message.
/etc/termcapdefault termcap terminal capability database
This command is an SVr4 curses and ncurses
extension.
X/Open Curses Issue 7 (2009) does not specify this command.
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.
Eric S. Raymond <esr@snark.thyrsus.com> and
Thomas E. Dickey <dickey@invisible-island.net>