t
***************************************************************************
Copyright 2018-2023,2024 Thomas E. Dickey *
Copyright 1998-2010,2016 Free Software Foundation, Inc. *
*
Permission is hereby granted, free of charge, to any person obtaining a *
copy of this software and associated documentation files (the *
"Software"), to deal in the Software without restriction, including *
without limitation the rights to use, copy, modify, merge, publish, *
distribute, distribute with modifications, sublicense, and/or sell *
copies of the Software, and to permit persons to whom the Software is *
furnished to do so, subject to the following conditions: *
*
The above copyright notice and this permission notice shall be included *
in all copies or substantial portions of the Software. *
*
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS *
OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF *
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. *
IN NO EVENT SHALL THE ABOVE COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, *
DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR *
OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR *
THE USE OR OTHER DEALINGS IN THE SOFTWARE. *
*
Except as contained in this notice, the name(s) of the above copyright *
holders shall not be used in advertising or otherwise to promote the *
sale, use or other dealings in this Software without prior written *
authorization. *
***************************************************************************

$Id: captoinfo.1m,v 1.63 2024/03/23 20:37:25 tom Exp $
.\} .\} \%@CAPTOINFO@ - convert a termcap description into a \%term\%info 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 \%\%term\%info description to the standard output stream. \%termcap tc capabilities translate to \%\%term\%info \*(``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 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.

\%@CAPTOINFO@ translates some obsolete, nonstandard capabilities into standard (SVr4/XSI Curses) \%\%term\%info 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.

DWB 3.3 tbl requires the two junk "L" specifiers in the first row.

Name

Obsolete Standard Origin \f(BIterminfo capability

BO mr AT&T enter_reverse_mode

CI vi AT&T cursor_invisible

CV ve AT&T cursor_normal

DS mh AT&T enter_dim_mode

EE me AT&T exit_attribute_mode

FE LF AT&T label_on

FL LO AT&T label_off

XS mk AT&T enter_secure_mode

EN @7 XENIX key_end

GE ae XENIX exit_alt_charset_mode

GS as XENIX enter_alt_charset_mode

HM kh XENIX key_home

LD kL XENIX key_dl

PD kN XENIX key_npage

PN po XENIX prtr_off

PS pf XENIX prtr_on

PU kP XENIX key_ppage

RT @8 XENIX kent

UP ku XENIX kcuu1

KA k; Tektronix key_f10

KB F1 Tektronix key_f11

KC F2 Tektronix key_f12

KD F3 Tektronix key_f13

KE F4 Tektronix key_f14

KF F5 Tektronix key_f15

BC Sb Tektronix set_background

FC Sf Tektronix set_foreground

HS mh IRIX enter_dim_mode

XENIX \%termcap had a set of extension capabilities, corresponding to box drawing characters of CCSID (\*(``code page\*('') 437, as follows.

\f(BItermcap Name 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

.\" TODO: There are about 40 box drawing code points in CCSID 437;

.\" were there no XENIX capabilities for the mixed single- and double-

.\" line intersections?

.\"

.\" TODO: GG doesn't seem to fit with the others; explain it.

GG ACS 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 \%\%term\%info facility descended from SVr1 \%\%term\%info, but which is incompatible with the SVr4 format. \%@CAPTOINFO@ translates the following AIX extensions.

IBM XSI

ksel kslt

kbtab kcbt

font0 s0ds

font1 s1ds

font2 s2ds

font3 s3ds

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

The HP-UX \%\%term\%info library supports two nonstandard \%\%term\%info capabilities, meml (memory lock) and memu (memory unlock). \%@CAPTOINFO@ discards these with a warning message.

/etc/termcap default \%termcap terminal capability database

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.

Eric S. Raymond <esr@snark.thyrsus.com> and

Thomas E. Dickey <dickey@invisible-island.net>

\%@INFOCMP@(1M), \%@TIC@(1M), \%curses(3X), \%terminfo(5)