696 lines
25 KiB
HTML
696 lines
25 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of infocmp</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>infocmp</H1>
|
|
Section: User Commands (1)<BR>Updated: <BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
<B>infocmp</B> - compare or print out <I>terminfo</I> descriptions
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<B>infocmp</B> [<B>-1CDEFGIKLTUVWcdegilnpqrtux</B>]
|
|
<BR>
|
|
|
|
<BR> [<B>-v</B> <I>n</I>] [<B>-s d</B>| <B>i</B>| <B>l</B>| <B>c</B>] [<B>-Q</B> <I>n</I>] [<B>-R </B><B>subset</B>]
|
|
<BR>
|
|
|
|
<BR> [<B>-w</B> <I>width</I>] [<B>-A</B> <I>directory</I>] [<B>-B</B> <I>directory</I>]
|
|
<BR>
|
|
|
|
<BR> [<I>termname</I>...]
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
<B>infocmp</B> can be used to compare a binary <B>terminfo</B> entry with other
|
|
terminfo entries, rewrite a <B>terminfo</B> description to take advantage of the
|
|
<B>use=</B> terminfo field, or print out a <B>terminfo</B> description from the
|
|
binary file (<B>term</B>) in a variety of formats.
|
|
In all cases, the boolean
|
|
fields will be printed first, followed by the numeric fields, followed by the
|
|
string fields.
|
|
<A NAME="lbAE"> </A>
|
|
<H3>Default Options</H3>
|
|
|
|
If no options are specified and zero or one <I>termnames</I> are specified, the
|
|
<B>-I</B> option will be assumed.
|
|
If more than one <I>termname</I> is specified,
|
|
the <B>-d</B> option will be assumed.
|
|
<A NAME="lbAF"> </A>
|
|
<H3>Comparison Options [-d] [-c] [-n]</H3>
|
|
|
|
<B>infocmp</B> compares the <B>terminfo</B> description of the first terminal
|
|
<I>termname</I> with each of the descriptions given by the entries for the other
|
|
terminal's <I>termnames</I>.
|
|
If a capability is defined for only one of the
|
|
terminals, the value returned depends on the type of the capability:
|
|
|
|
<BR> .IP • 4
|
|
|
|
|
|
<B>F</B> for missing boolean variables
|
|
|
|
<BR> .IP • 4
|
|
|
|
|
|
<B>NULL</B> for missing integer or string variables
|
|
<P>
|
|
|
|
Use the <B>-q</B> option to show the distinction between
|
|
<I>absent</I> and <I>cancelled</I> capabilities.
|
|
<P>
|
|
|
|
These options produce a list which you can use to compare two
|
|
or more terminal descriptions:
|
|
<DL COMPACT>
|
|
<DT id="1"><B>-d</B><DD>
|
|
produces a list of each capability that is <I>different</I>
|
|
between two entries.
|
|
Each item in the list shows ``:'' after the capability name,
|
|
followed by the capability values, separated by a comma.
|
|
<DT id="2"><B>-c</B><DD>
|
|
produces a list of each capability that is <I>common</I> between
|
|
two or more entries.
|
|
Missing capabilities are ignored.
|
|
Each item in the list shows ``='' after the capability name,
|
|
followed by the capability value.
|
|
<DT id="3"><DD>
|
|
The <B>-u</B> option provides a related output,
|
|
showing the first terminal description rewritten to use the second
|
|
as a building block via the ``use='' clause.
|
|
<DT id="4"><B>-n</B><DD>
|
|
produces a list of each capability that is in <I>none</I> of the given entries.
|
|
Each item in the list shows ``!'' before the capability name.
|
|
<DT id="5"><DD>
|
|
Normally only the conventional capabilities are shown.
|
|
Use the <B>-x</B> option to add the BSD-compatibility
|
|
capabilities (names prefixed with ``OT'').
|
|
<DT id="6"><DD>
|
|
If no <I>termnames</I> are given,
|
|
<B>infocmp</B> uses the environment variable <B>TERM</B>
|
|
for each of the <I>termnames</I>.
|
|
</DL>
|
|
<A NAME="lbAG"> </A>
|
|
<H3>Source Listing Options [-I] [-L] [-C] [-r]</H3>
|
|
|
|
The <B>-I</B>, <B>-L</B>, and <B>-C</B> options will produce
|
|
a source listing for each terminal named.
|
|
<CENTER><TABLE>
|
|
<TR VALIGN=top><TD><B>-I</B></TD><TD>use the <B>terminfo</B> names<BR></TD></TR>
|
|
<TR VALIGN=top><TD><B>-L</B></TD><TD>use the long C variable name listed in <<B>term.h</B>><BR></TD></TR>
|
|
<TR VALIGN=top><TD><B>-C</B></TD><TD>use the <B>termcap</B> names<BR></TD></TR>
|
|
<TR VALIGN=top><TD><B>-r</B></TD><TD>when using <B>-C</B>, put out all capabilities in <B>termcap</B> form<BR></TD></TR>
|
|
<TR VALIGN=top><TD><B>-K</B></TD><TD>modifies the <B>-C</B> option, improving BSD-compatibility.<BR></TD></TR>
|
|
</TABLE></CENTER>
|
|
|
|
<P>
|
|
|
|
If no <I>termnames</I> are given, the environment variable <B>TERM</B> will be
|
|
used for the terminal name.
|
|
<P>
|
|
|
|
The source produced by the <B>-C</B> option may be used directly as a
|
|
<B>termcap</B> entry, but not all parameterized strings can be changed to
|
|
the <B>termcap</B> format.
|
|
<B>infocmp</B> will attempt to convert most of the
|
|
parameterized information, and anything not converted will be plainly marked in
|
|
the output and commented out.
|
|
These should be edited by hand.
|
|
<P>
|
|
|
|
For best results when converting to <B>termcap</B> format,
|
|
you should use both <B>-C</B> and <B>-r</B>.
|
|
Normally a termcap description is limited to 1023 bytes.
|
|
<B>infocmp</B> trims away less essential parts to make it fit.
|
|
If you are converting to one of the (rare) termcap implementations
|
|
which accept an unlimited size of termcap,
|
|
you may want to add the <B>-T</B> option.
|
|
More often however, you must help the termcap implementation,
|
|
and trim excess whitespace (use the <B>-0</B> option for that).
|
|
<P>
|
|
|
|
All padding information for strings will be collected together and placed
|
|
at the beginning of the string where <B>termcap</B> expects it.
|
|
Mandatory
|
|
padding (padding information with a trailing ``/'') will become optional.
|
|
<P>
|
|
|
|
All <B>termcap</B> variables no longer supported by <B>terminfo</B>, but which
|
|
are derivable from other <B>terminfo</B> variables, will be output.
|
|
Not all
|
|
<B>terminfo</B> capabilities will be translated; only those variables which were
|
|
part of <B>termcap</B> will normally be output.
|
|
Specifying the <B>-r</B> option
|
|
will take off this restriction, allowing all capabilities to be output in
|
|
<I>termcap</I> form.
|
|
Normally you would use both the <B>-C</B> and <B>-r</B> options.
|
|
The actual format used incorporates some improvements for escaped characters
|
|
from terminfo format.
|
|
For a stricter BSD-compatible translation, use the <B>-K</B> option
|
|
rather than <B>-C</B>.
|
|
<P>
|
|
|
|
Note that because padding is collected to the beginning of the capability, not
|
|
all capabilities are output.
|
|
Mandatory padding is not supported.
|
|
Because
|
|
<B>termcap</B> strings are not as flexible, it is not always possible to convert
|
|
a <B>terminfo</B> string capability into an equivalent <B>termcap</B> format.
|
|
A subsequent conversion of the <B>termcap</B> file
|
|
back into <B>terminfo</B> format
|
|
will not necessarily reproduce the original <B>terminfo</B> source.
|
|
<P>
|
|
|
|
Some common <B>terminfo</B> parameter sequences, their <B>termcap</B>
|
|
equivalents, and some terminal types which commonly have such sequences, are:
|
|
<CENTER><TABLE>
|
|
<TR VALIGN=top><TD><B>terminfo</B></TD><TD ALIGN=center>termcap</TD><TD>Representative Terminals<BR></TD></TR>
|
|
<TR VALIGN=top><TD COLSPAN=3><HR><HR></TD></TR>
|
|
<TR VALIGN=top><TD><B>%p1%c</B></TD><TD>%.</TD><TD>adm<BR></TD></TR>
|
|
<TR VALIGN=top><TD><B>%p1%d</B></TD><TD>%d</TD><TD>hp, ANSI standard, vt100<BR></TD></TR>
|
|
<TR VALIGN=top><TD><B>%p1%'x'%+%c</B></TD><TD>%+x</TD><TD>concept<BR></TD></TR>
|
|
<TR VALIGN=top><TD><B>%i</B></TD><TD>%iq</TD><TD>ANSI standard, vt100<BR></TD></TR>
|
|
<TR VALIGN=top><TD><B>%p1%?%'x'%>%t%p1%'y'%+%;</B></TD><TD>%>xy</TD><TD>concept<BR></TD></TR>
|
|
<TR VALIGN=top><TD><B>%p2</B> is printed before <B>%p1</B></TD><TD>%r</TD><TD>hp<BR></TD></TR>
|
|
</TABLE></CENTER>
|
|
|
|
<A NAME="lbAH"> </A>
|
|
<H3>Use= Option [-u]</H3>
|
|
|
|
The <B>-u</B> option produces a <B>terminfo</B> source description of the first
|
|
terminal <I>termname</I> which is relative to the sum of the descriptions given
|
|
by the entries for the other terminals <I>termnames</I>.
|
|
It does this by
|
|
analyzing the differences between the first <I>termname</I> and the other
|
|
<I>termnames</I> and producing a description with <B>use=</B> fields for the
|
|
other terminals.
|
|
In this manner, it is possible to retrofit generic terminfo
|
|
entries into a terminal's description.
|
|
Or, if two similar terminals exist, but
|
|
were coded at different times or by different people so that each description
|
|
is a full description, using <B>infocmp</B>
|
|
will show what can be done to change
|
|
one description to be relative to the other.
|
|
<P>
|
|
|
|
A capability will get printed with an at-sign (@) if it no longer exists in the
|
|
first <I>termname</I>, but one of the other <I>termname</I> entries contains a
|
|
value for it.
|
|
A capability's value gets printed if the value in the first
|
|
<I>termname</I> is not found in any of the other <I>termname</I> entries, or if
|
|
the first of the other <I>termname</I> entries that has this capability gives a
|
|
different value for the capability than that in the first <I>termname</I>.
|
|
<P>
|
|
|
|
The order of the other <I>termname</I> entries is significant.
|
|
Since the
|
|
terminfo compiler <B>tic</B> does a left-to-right scan of the capabilities,
|
|
specifying two <B>use=</B> entries that contain differing entries for the same
|
|
capabilities will produce different results depending on the order that the
|
|
entries are given in.
|
|
<B>infocmp</B> will flag any such inconsistencies between
|
|
the other <I>termname</I> entries as they are found.
|
|
<P>
|
|
|
|
Alternatively, specifying a capability <I>after</I> a <B>use=</B> entry that
|
|
contains that capability will cause the second specification to be ignored.
|
|
Using <B>infocmp</B> to recreate a description can be a useful check to make
|
|
sure that everything was specified correctly in the original source
|
|
description.
|
|
<P>
|
|
|
|
Another error that does not cause incorrect compiled files, but will slow down
|
|
the compilation time, is specifying extra <B>use=</B> fields that are
|
|
superfluous.
|
|
<B>infocmp</B> will flag any other <I>termname use=</I> fields that
|
|
were not needed.
|
|
<A NAME="lbAI"> </A>
|
|
<H3>Changing Databases [-A <I>directory</I>] [-B <I>directory</I>]</H3>
|
|
|
|
Like other <B>ncurses</B> utilities,
|
|
<B>infocmp</B> looks for the terminal descriptions in several places.
|
|
You can use the <B>TERMINFO</B> and <B>TERMINFO_DIRS</B> environment variables
|
|
to override the compiled-in default list of places to search
|
|
(see <B><A HREF="/cgi-bin/man/man2html?3X+curses">curses</A></B>(3X) for details).
|
|
<P>
|
|
|
|
You can also use the options <B>-A</B>
|
|
and <B>-B</B> to override the list of places to search
|
|
when comparing terminal descriptions:
|
|
|
|
<BR> .IP • 4
|
|
|
|
|
|
The <B>-A</B> option sets the location for the first <I>termname</I>
|
|
|
|
<BR> .IP • 4
|
|
|
|
|
|
The <B>-B</B> option sets the location for the other <I>termnames</I>.
|
|
<P>
|
|
|
|
Using these options, it is possible to
|
|
compare descriptions for a terminal with the same name located in two different
|
|
databases.
|
|
For instance,
|
|
you can use this feature for comparing descriptions for the same terminal
|
|
created by different people.
|
|
<A NAME="lbAJ"> </A>
|
|
<H3>Other Options</H3>
|
|
|
|
<DL COMPACT>
|
|
<DT id="7"><B>-0</B><DD>
|
|
causes the fields to be printed on one line, without wrapping.
|
|
<DT id="8"><B>-1</B><DD>
|
|
causes the fields to be printed out one to a line.
|
|
Otherwise,
|
|
the fields will be printed several to a line to a maximum width
|
|
of 60 characters.
|
|
<DT id="9"><B>-a</B><DD>
|
|
tells <B>infocmp</B> to retain commented-out capabilities
|
|
rather than discarding them.
|
|
Capabilities are commented by prefixing them with a period.
|
|
<DT id="10"><B>-D</B><DD>
|
|
tells <B>infocmp</B> to print the database locations that it knows about,
|
|
and exit.
|
|
<DT id="11"><B>-E</B><DD>
|
|
Dump the capabilities of the given terminal as tables, needed in
|
|
the C initializer for a
|
|
TERMTYPE structure (the terminal capability structure in the <B><<A HREF="file:///usr/include/term.h">term.h</A>></B>).
|
|
This option is useful for preparing versions of the curses library hardwired
|
|
for a given terminal type.
|
|
The tables are all declared static, and are named according to the type
|
|
and the name of the corresponding terminal entry.
|
|
<P>
|
|
Before ncurses 5.0, the split between the <B>-e</B> and <B>-E</B>
|
|
options was not needed; but support for extended names required making
|
|
the arrays of terminal capabilities separate from the TERMTYPE structure.
|
|
<DT id="12"><B>-e</B><DD>
|
|
Dump the capabilities of the given terminal as a C initializer for a
|
|
TERMTYPE structure (the terminal capability structure in the <B><<A HREF="file:///usr/include/term.h">term.h</A>></B>).
|
|
This option is useful for preparing versions of the curses library hardwired
|
|
for a given terminal type.
|
|
<DT id="13"><B>-F</B><DD>
|
|
compare terminfo files.
|
|
This assumes that two following arguments are filenames.
|
|
The files are searched for pairwise matches between
|
|
entries, with two entries considered to match if any of their names do.
|
|
The report printed to standard output lists entries with no matches in
|
|
the other file, and entries with more than one match.
|
|
For entries
|
|
with exactly one match it includes a difference report.
|
|
Normally,
|
|
to reduce the volume of the report, use references are
|
|
not resolved before looking for differences, but resolution can be forced
|
|
by also specifying <B>-r</B>.
|
|
<DT id="14"><B>-f</B><DD>
|
|
Display complex terminfo strings which contain if/then/else/endif expressions
|
|
indented for readability.
|
|
<DT id="15"><B>-G</B><DD>
|
|
Display constant literals in decimal form
|
|
rather than their character equivalents.
|
|
<DT id="16"><B>-g</B><DD>
|
|
Display constant character literals in quoted form
|
|
rather than their decimal equivalents.
|
|
<DT id="17"><B>-i</B><DD>
|
|
Analyze the initialization (<B>is1</B>, <B>is2</B>, <B>is3</B>), and reset
|
|
(<B>rs1</B>, <B>rs2</B>, <B>rs3</B>), strings in the entry,
|
|
as well as those used for starting/stopping cursor-positioning mode
|
|
(<B>smcup</B>, <B>rmcup</B>) as well as starting/stopping keymap mode
|
|
(<B>smkx</B>, <B>rmkx</B>).
|
|
<DT id="18"><DD>
|
|
For each string, the
|
|
code tries to analyze it into actions in terms of the other capabilities in the
|
|
entry, certain X3.64/ISO 6429/ECMA-48 capabilities, and certain DEC VT-series
|
|
private modes (the set of recognized special sequences has been selected for
|
|
completeness over the existing terminfo database).
|
|
Each report line consists
|
|
of the capability name, followed by a colon and space, followed by a printable
|
|
expansion of the capability string with sections matching recognized actions
|
|
translated into {}-bracketed descriptions.
|
|
<DT id="19"><DD>
|
|
Here is a list of the DEC/ANSI
|
|
special sequences recognized:
|
|
<CENTER><TABLE>
|
|
<TR VALIGN=top><TD>Action</TD><TD>Meaning<BR></TD></TR>
|
|
<TR VALIGN=top><TD COLSPAN=2><HR><HR></TD></TR>
|
|
<TR VALIGN=top><TD>RIS</TD><TD>full reset<BR></TD></TR>
|
|
<TR VALIGN=top><TD>SC</TD><TD>save cursor<BR></TD></TR>
|
|
<TR VALIGN=top><TD>RC</TD><TD>restore cursor<BR></TD></TR>
|
|
<TR VALIGN=top><TD>LL</TD><TD>home-down<BR></TD></TR>
|
|
<TR VALIGN=top><TD>RSR</TD><TD>reset scroll region<BR></TD></TR>
|
|
<TR VALIGN=top><TD COLSPAN=2><HR><HR></TD></TR>
|
|
<TR VALIGN=top><TD>DECSTR</TD><TD>soft reset (VT320)<BR></TD></TR>
|
|
<TR VALIGN=top><TD>S7C1T</TD><TD>7-bit controls (VT220)<BR></TD></TR>
|
|
<TR VALIGN=top><TD COLSPAN=2><HR><HR></TD></TR>
|
|
<TR VALIGN=top><TD>ISO DEC G0</TD><TD>enable DEC graphics for G0<BR></TD></TR>
|
|
<TR VALIGN=top><TD>ISO UK G0</TD><TD>enable UK chars for G0<BR></TD></TR>
|
|
<TR VALIGN=top><TD>ISO US G0</TD><TD>enable US chars for G0<BR></TD></TR>
|
|
<TR VALIGN=top><TD>ISO DEC G1</TD><TD>enable DEC graphics for G1<BR></TD></TR>
|
|
<TR VALIGN=top><TD>ISO UK G1</TD><TD>enable UK chars for G1<BR></TD></TR>
|
|
<TR VALIGN=top><TD>ISO US G1</TD><TD>enable US chars for G1<BR></TD></TR>
|
|
<TR VALIGN=top><TD COLSPAN=2><HR><HR></TD></TR>
|
|
<TR VALIGN=top><TD>DECPAM</TD><TD>application keypad mode<BR></TD></TR>
|
|
<TR VALIGN=top><TD>DECPNM</TD><TD>normal keypad mode<BR></TD></TR>
|
|
<TR VALIGN=top><TD>DECANSI</TD><TD>enter ANSI mode<BR></TD></TR>
|
|
<TR VALIGN=top><TD COLSPAN=2><HR><HR></TD></TR>
|
|
<TR VALIGN=top><TD>ECMA[+-]AM</TD><TD>keyboard action mode<BR></TD></TR>
|
|
<TR VALIGN=top><TD>ECMA[+-]IRM</TD><TD>insert replace mode<BR></TD></TR>
|
|
<TR VALIGN=top><TD>ECMA[+-]SRM</TD><TD>send receive mode<BR></TD></TR>
|
|
<TR VALIGN=top><TD>ECMA[+-]LNM</TD><TD>linefeed mode<BR></TD></TR>
|
|
<TR VALIGN=top><TD COLSPAN=2><HR><HR></TD></TR>
|
|
<TR VALIGN=top><TD>DEC[+-]CKM</TD><TD>application cursor keys<BR></TD></TR>
|
|
<TR VALIGN=top><TD>DEC[+-]ANM</TD><TD>set VT52 mode<BR></TD></TR>
|
|
<TR VALIGN=top><TD>DEC[+-]COLM</TD><TD>132-column mode<BR></TD></TR>
|
|
<TR VALIGN=top><TD>DEC[+-]SCLM</TD><TD>smooth scroll<BR></TD></TR>
|
|
<TR VALIGN=top><TD>DEC[+-]SCNM</TD><TD>reverse video mode<BR></TD></TR>
|
|
<TR VALIGN=top><TD>DEC[+-]OM</TD><TD>origin mode<BR></TD></TR>
|
|
<TR VALIGN=top><TD>DEC[+-]AWM</TD><TD>wraparound mode<BR></TD></TR>
|
|
<TR VALIGN=top><TD>DEC[+-]ARM</TD><TD>auto-repeat mode<BR></TD></TR>
|
|
</TABLE></CENTER>
|
|
|
|
<P>
|
|
It also recognizes a SGR action corresponding to ANSI/ISO 6429/ECMA Set
|
|
Graphics Rendition, with the values NORMAL, BOLD, UNDERLINE, BLINK, and
|
|
REVERSE.
|
|
All but NORMAL may be prefixed with
|
|
<DL COMPACT><DT id="20"><DD>
|
|
|
|
<BR> .IP • 4
|
|
|
|
|
|
``+'' (turn on) or
|
|
|
|
<BR> .IP • 4
|
|
|
|
|
|
``-'' (turn off).
|
|
</DL>
|
|
|
|
<DT id="21"><DD>
|
|
An SGR0 designates an empty highlight sequence (equivalent to {SGR:NORMAL}).
|
|
<DT id="22"><B>-l</B><DD>
|
|
Set output format to terminfo.
|
|
<DT id="23"><B>-p</B><DD>
|
|
Ignore padding specifications when comparing strings.
|
|
<DT id="24"><B>-Q</B> <I>n</I><DD>
|
|
Rather than show source in terminfo (text) format,
|
|
print the compiled (binary) format in hexadecimal or base64 form,
|
|
depending on the option's value:
|
|
<DL COMPACT><DT id="25"><DD>
|
|
<DL COMPACT>
|
|
<DT id="26">1<DD>
|
|
hexadecimal
|
|
<DT id="27">2<DD>
|
|
base64
|
|
<DT id="28">3<DD>
|
|
hexadecimal and base64
|
|
</DL>
|
|
</DL>
|
|
|
|
<DT id="29"><DD>
|
|
For example, this prints the compiled terminfo value as a string
|
|
which could be assigned to the <B>TERMINFO</B> environment variable:
|
|
|
|
<BR> .sp
|
|
|
|
<BR> .in +4
|
|
|
|
<PRE>
|
|
infocmp -0 -q -Q2
|
|
|
|
</PRE>
|
|
|
|
|
|
<BR> .in -4
|
|
|
|
|
|
<DT id="30"><B>-q</B><DD>
|
|
This makes the output a little shorter:
|
|
<DL COMPACT><DT id="31"><DD>
|
|
|
|
<BR> .IP • 4
|
|
|
|
|
|
Make the comparison listing shorter by omitting subheadings, and using
|
|
``-'' for absent capabilities, ``@''
|
|
for canceled rather than ``NULL''.
|
|
|
|
<BR> .IP • 4
|
|
|
|
|
|
However, show differences between absent and cancelled capabilities.
|
|
|
|
<BR> .IP • 4
|
|
|
|
|
|
Omit the ``Reconstructed from'' comment for source listings.
|
|
</DL>
|
|
|
|
<DT id="32"><B>-R</B><I>subset</I><DD>
|
|
Restrict output to a given subset.
|
|
This option is for use with archaic
|
|
versions of terminfo like those on SVr1, Ultrix, or HP/UX that do not support
|
|
the full set of SVR4/XSI Curses terminfo; and variants such as AIX
|
|
that have their own extensions incompatible with SVr4/XSI.
|
|
<DL COMPACT><DT id="33"><DD>
|
|
|
|
<BR> .IP • 4
|
|
|
|
|
|
Available terminfo
|
|
subsets are ``SVr1'', ``Ultrix'', ``HP'', and ``AIX'';
|
|
see <B><A HREF="/cgi-bin/man/man2html?5+terminfo">terminfo</A></B>(5) for details.
|
|
|
|
<BR> .IP • 4
|
|
|
|
|
|
You can also choose the subset ``BSD'' which selects only capabilities
|
|
with termcap equivalents recognized by 4.4BSD.
|
|
The <B>-C</B> option sets the ``BSD'' subset as a side-effect.
|
|
|
|
<BR> .IP • 4
|
|
|
|
|
|
If you select any other value for <B>-R</B>,
|
|
it is the same as no subset, i.e., all capabilities are used.
|
|
The <B>-I</B> option likewise selects no subset as a side-effect.
|
|
</DL>
|
|
|
|
<DT id="34"><B>-s </B><I>[d|i|l|c]</I><DD>
|
|
The <B>-s</B> option sorts the fields within each type according to the argument
|
|
below:
|
|
<BR>
|
|
|
|
<DL COMPACT><DT id="35"><DD>
|
|
<DL COMPACT>
|
|
<DT id="36"><B>d</B><DD>
|
|
leave fields in the order that they are stored in the <I>terminfo</I> database.
|
|
<DT id="37"><B>i</B><DD>
|
|
sort by <I>terminfo</I> name.
|
|
<DT id="38"><B>l</B><DD>
|
|
sort by the long C variable name.
|
|
<DT id="39"><B>c</B><DD>
|
|
sort by the <I>termcap</I> name.
|
|
</DL>
|
|
</DL>
|
|
|
|
<DT id="40"><DD>
|
|
If the <B>-s</B> option is not given, the fields printed out will be
|
|
sorted alphabetically by the <B>terminfo</B> name within each type,
|
|
except in the case of the <B>-C</B> or the <B>-L</B> options, which cause the
|
|
sorting to be done by the <B>termcap</B> name or the long C variable
|
|
name, respectively.
|
|
<DT id="41"><B>-T</B><DD>
|
|
eliminates size-restrictions on the generated text.
|
|
This is mainly useful for testing and analysis, since the compiled
|
|
descriptions are limited (e.g., 1023 for termcap, 4096 for terminfo).
|
|
<DT id="42"><B>-t</B><DD>
|
|
tells <B>tic</B> to discard commented-out capabilities.
|
|
Normally when translating from terminfo to termcap,
|
|
untranslatable capabilities are commented-out.
|
|
<DT id="43"><B>-U</B><DD>
|
|
tells <B>infocmp</B> to not post-process the data
|
|
after parsing the source file.
|
|
This feature helps when comparing the actual contents of two source files,
|
|
since it excludes the inferences that <B>infocmp</B> makes to fill in missing
|
|
data.
|
|
<DT id="44"><B>-V</B><DD>
|
|
reports the version of ncurses which was used in this program, and exits.
|
|
<DT id="45"><B>-v</B> <I>n</I><DD>
|
|
prints out tracing information on standard error as the program runs.
|
|
<DT id="46"><DD>
|
|
The optional parameter <I>n</I> is a number from 1 to 10, inclusive,
|
|
indicating the desired level of detail of information.
|
|
If ncurses is built without tracing support, the optional parameter is ignored.
|
|
<DT id="47"><B>-W</B><DD>
|
|
By itself, the <B>-w</B> option will not force long strings to be wrapped.
|
|
Use the <B>-W</B> option to do this.
|
|
<DT id="48"><B>-w</B> <I>width</I><DD>
|
|
changes the output to <I>width</I> characters.
|
|
<DT id="49"><B>-x</B><DD>
|
|
print information for user-defined capabilities (see <B><A HREF="/cgi-bin/man/man2html?5+user_caps">user_caps</A>(5)</B>.
|
|
These are extensions to the terminfo repertoire which can be loaded
|
|
using the <B>-x</B> option of <B>tic</B>.
|
|
</DL>
|
|
<A NAME="lbAK"> </A>
|
|
<H2>FILES</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="50">/etc/terminfo<DD>
|
|
Compiled terminal description database.
|
|
</DL>
|
|
<A NAME="lbAL"> </A>
|
|
<H2>HISTORY</H2>
|
|
|
|
Although System V Release 2 provided a terminfo library,
|
|
it had no documented tool for decompiling the terminal descriptions.
|
|
Tony Hansen (AT&T) wrote the first <B>infocmp</B> in early 1984,
|
|
for System V Release 3.
|
|
<P>
|
|
|
|
Eric Raymond used the AT&T documentation in 1995 to provide an equivalent
|
|
<B>infocmp</B> for ncurses.
|
|
In addition, he added a few new features such as:
|
|
|
|
<BR> .IP • 4
|
|
|
|
|
|
the <B>-e</B> option, to support <I>fallback</I>
|
|
(compiled-in) terminal descriptions
|
|
|
|
<BR> .IP • 4
|
|
|
|
|
|
the <B>-i</B> option, to help with analysis
|
|
<P>
|
|
|
|
Later, Thomas Dickey added the <B>-x</B> (user-defined capabilities)
|
|
option, and the <B>-E</B> option to support fallback entries with
|
|
user-defined capabilities.
|
|
<P>
|
|
|
|
For a complete list, see the <I>EXTENSIONS</I> section.
|
|
<P>
|
|
|
|
In 2010, Roy Marples provided an <B>infocmp</B> program for NetBSD.
|
|
It is less capable than the SVr4 or ncurses versions
|
|
(e.g., it lacks the sorting options documented in X/Open),
|
|
but does include the <B>-x</B> option adapted from ncurses.
|
|
<A NAME="lbAM"> </A>
|
|
<H2>PORTABILITY</H2>
|
|
|
|
X/Open Curses, Issue 7 (2009) provides a description of <B>infocmp</B>.
|
|
It does not mention the options used for converting to termcap format.
|
|
<A NAME="lbAN"> </A>
|
|
<H2>EXTENSIONS</H2>
|
|
|
|
The
|
|
<B>-0</B>,
|
|
<B>-1</B>,
|
|
<B>-E</B>,
|
|
<B>-F</B>,
|
|
<B>-G</B>,
|
|
<B>-Q</B>,
|
|
<B>-R</B>,
|
|
<B>-T</B>,
|
|
<B>-V</B>,
|
|
<B>-a</B>,
|
|
<B>-e</B>,
|
|
<B>-f</B>,
|
|
<B>-g</B>,
|
|
<B>-i</B>,
|
|
<B>-l</B>,
|
|
<B>-p</B>,
|
|
<B>-q</B> and
|
|
<B>-t</B>
|
|
options are not supported in SVr4 curses.
|
|
<P>
|
|
|
|
SVr4 infocmp does not distinguish between absent and cancelled capabilities.
|
|
Also, it shows missing integer capabilities as <B>-1</B>
|
|
(the internal value used to represent missing integers).
|
|
This implementation shows those as ``NULL'',
|
|
for consistency with missing strings.
|
|
<P>
|
|
|
|
The <B>-r</B> option's notion of ``termcap'' capabilities
|
|
is System V Release 4's.
|
|
Actual BSD curses versions will have a more restricted set.
|
|
To see only the
|
|
4.4BSD set, use <B>-r</B> <B>-RBSD</B>.
|
|
<A NAME="lbAO"> </A>
|
|
<H2>BUGS</H2>
|
|
|
|
The <B>-F</B> option of <B><A HREF="/cgi-bin/man/man2html?1+infocmp">infocmp</A></B>(1) should be a <B><A HREF="/cgi-bin/man/man2html?1+toe">toe</A></B>(1) mode.
|
|
<A NAME="lbAP"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+captoinfo">captoinfo</A></B>(1),
|
|
<B><A HREF="/cgi-bin/man/man2html?1+infotocap">infotocap</A></B>(1),
|
|
<B><A HREF="/cgi-bin/man/man2html?1+tic">tic</A></B>(1),
|
|
<B><A HREF="/cgi-bin/man/man2html?1+toe">toe</A></B>(1),
|
|
<B>ncurses</B>(3NCURSES),
|
|
<B><A HREF="/cgi-bin/man/man2html?5+terminfo">terminfo</A></B>(5).
|
|
<B><A HREF="/cgi-bin/man/man2html?5+user_caps">user_caps</A></B>(5).
|
|
<P>
|
|
<A HREF="https://invisible-island.net/ncurses/tctest.html">https://invisible-island.net/ncurses/tctest.html</A>
|
|
<P>
|
|
|
|
This describes <B>ncurses</B>
|
|
version 6.2 (patch 20200212).
|
|
<A NAME="lbAQ"> </A>
|
|
<H2>AUTHOR</H2>
|
|
|
|
Eric S. Raymond <<A HREF="mailto:esr@snark.thyrsus.com">esr@snark.thyrsus.com</A>>
|
|
and
|
|
<BR>
|
|
|
|
Thomas E. Dickey <<A HREF="mailto:dickey@invisible-island.net">dickey@invisible-island.net</A>>
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="51"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="52"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="53"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DL>
|
|
<DT id="54"><A HREF="#lbAE">Default Options</A><DD>
|
|
<DT id="55"><A HREF="#lbAF">Comparison Options [-d] [-c] [-n]</A><DD>
|
|
<DT id="56"><A HREF="#lbAG">Source Listing Options [-I] [-L] [-C] [-r]</A><DD>
|
|
<DT id="57"><A HREF="#lbAH">Use= Option [-u]</A><DD>
|
|
<DT id="58"><A HREF="#lbAI">Changing Databases [-A <I>directory</I>] [-B <I>directory</I>]</A><DD>
|
|
<DT id="59"><A HREF="#lbAJ">Other Options</A><DD>
|
|
</DL>
|
|
<DT id="60"><A HREF="#lbAK">FILES</A><DD>
|
|
<DT id="61"><A HREF="#lbAL">HISTORY</A><DD>
|
|
<DT id="62"><A HREF="#lbAM">PORTABILITY</A><DD>
|
|
<DT id="63"><A HREF="#lbAN">EXTENSIONS</A><DD>
|
|
<DT id="64"><A HREF="#lbAO">BUGS</A><DD>
|
|
<DT id="65"><A HREF="#lbAP">SEE ALSO</A><DD>
|
|
<DT id="66"><A HREF="#lbAQ">AUTHOR</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:05:17 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|