15589c42fa
Mostly this is intended to resolve the trace() badness once and for all. Obtained from: ftp://dickey.his.com/ncurses/
190 lines
6.4 KiB
Plaintext
190 lines
6.4 KiB
Plaintext
'\" t
|
|
.\"***************************************************************************
|
|
.\" Copyright (c) 1998,2000 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.14 2000/03/19 02:20:28 tom Exp $
|
|
.TH captoinfo 1M ""
|
|
.ds n 5
|
|
.ds d @DATADIR@/terminfo
|
|
.SH NAME
|
|
\fBcaptoinfo\fR - convert a \fItermcap\fR description into a \fIterminfo\fR description
|
|
.SH SYNOPSIS
|
|
\fBcaptoinfo\fR [\fB-v\fR\fIn\fR \fIwidth\fR] [\fB-V\fR] [\fB-1\fR] [\fB-w\fR \fIwidth\fR] \fIfile\fR . . .
|
|
.SH DESCRIPTION
|
|
\fBcaptoinfo\fR looks in \fIfile\fR for \fBtermcap\fR descriptions. For each
|
|
one found, an equivalent \fBterminfo\fR description is written to standard
|
|
output. Termcap \fBtc\fR capabilities are translated directly to terminfo
|
|
\fBuse\fR capabilities.
|
|
|
|
If no \fIfile\fR is given, then the environment variable \fBTERMCAP\fR is used
|
|
for the filename or entry. If \fBTERMCAP\fR is a full pathname to a file, only
|
|
the terminal whose name is specified in the environment variable \fBTERM\fR is
|
|
extracted from that file. If the environment variable \fBTERMCAP\fR is not
|
|
set, then the file \fB\*d\fR is read.
|
|
.TP 5
|
|
\fB-v\fR
|
|
print out tracing information on standard error as the program runs.
|
|
.TP 5
|
|
\fB-V\fR
|
|
print out the version of the program in use on standard error and exit.
|
|
.TP 5
|
|
\fB-1\fR
|
|
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.
|
|
.TP 5
|
|
\fB-w\fR
|
|
change the output to \fIwidth\fR characters.
|
|
.SH FILES
|
|
.TP 20
|
|
\*d
|
|
Compiled terminal description database.
|
|
.SH TRANSLATIONS FROM NONSTANDARD CAPABILITIES
|
|
.PP
|
|
Some obsolete nonstandard capabilities will automatically be translated
|
|
into standard (SVr4/XSI Curses) terminfo capabilities by \fBcaptoinfo\fR.
|
|
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.
|
|
.PP
|
|
.TS H
|
|
c c c c
|
|
c c c c
|
|
l l l l.
|
|
Nonstd Std From Terminfo
|
|
name name 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; Tek key_f10
|
|
KB F1 Tek key_f11
|
|
KC F2 Tek key_f12
|
|
KD F3 Tek key_f13
|
|
KE F4 Tek key_f14
|
|
KF F5 Tek key_f15
|
|
BC Sb Tek set_background
|
|
FC Sf Tek set_foreground
|
|
HS mh Iris enter_dim_mode
|
|
.TE
|
|
.PP
|
|
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:
|
|
.PP
|
|
.TS H
|
|
c c
|
|
l l.
|
|
Cap Graphic
|
|
_
|
|
G2 upper left
|
|
G3 lower left
|
|
G1 upper right
|
|
G4 lower right
|
|
GR pointing right
|
|
GL pointing left
|
|
GU pointing up
|
|
GD pointing down
|
|
GH horizontal line
|
|
GV vertical line
|
|
GC intersection
|
|
G6 upper left
|
|
G7 lower left
|
|
G5 upper right
|
|
G8 lower right
|
|
Gr tee pointing right
|
|
Gr tee pointing left
|
|
Gu tee pointing up
|
|
Gd tee pointing down
|
|
Gh horizontal line
|
|
Gv vertical line
|
|
Gc intersection
|
|
GG acs magic cookie count
|
|
.TE
|
|
.PP
|
|
If the single-line capabilities occur in an entry, they will automatically
|
|
be composed into an \fBacsc\fR string. The double-line capabilities and
|
|
\fBGG\fR are discarded with a warning message.
|
|
.PP
|
|
IBM's AIX has a terminfo facility descended from SVr1 terminfo but incompatible
|
|
with the SVr4 format. The following AIX extensions are automatically
|
|
translated:
|
|
.PP
|
|
.TS
|
|
c c
|
|
l l.
|
|
IBM XSI
|
|
_
|
|
ksel kslt
|
|
kbtab kcbt
|
|
font0 s0ds
|
|
font1 s1ds
|
|
font2 s2ds
|
|
font3 s3ds
|
|
.TE
|
|
.PP
|
|
Additionally, the AIX \fBbox1\fR capability will be automatically translated to
|
|
an \fBacsc\fR string.
|
|
.PP
|
|
Hewlett-Packard's terminfo library supports two nonstandard terminfo
|
|
capabilities \fBmeml\fR (memory lock) and \fBmemu\fR (memory unlock).
|
|
These will be discarded with a warning message.
|
|
.SH NOTES
|
|
This utility is actually a link to \fItic\fR(1M), running in \fI-I\fR mode.
|
|
You can use other \fItic\fR options such as \fB-f\fR and \fB-x\fR.
|
|
|
|
The trace option isn't identical to SVr4's. Under SVr4, instead of following
|
|
the -v with a trace level n, you repeat it n times.
|
|
.SH SEE ALSO
|
|
\fBcurses\fR(3X), \fBinfocmp\fR(1M), \fBterminfo\fR(\*n)
|
|
.SH AUTHOR
|
|
Eric S. Raymond <esr@snark.thyrsus.com>
|
|
.\"#
|
|
.\"# The following sets edit modes for GNU EMACS
|
|
.\"# Local Variables:
|
|
.\"# mode:nroff
|
|
.\"# fill-column:79
|
|
.\"# End:
|