X-Git-Url: http://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Finfocmp.1m.html;h=6442c1a65dee434832bcd36eb79a20fbcc6e44c5;hp=67a9489f0ebcd39b59b659fe8fe14f68db120c21;hb=dcfe712cb3492636e8d50c9867cf05aec089a576;hpb=027d0c57c4c4d6690e8d8727888d3282dbe9aa86
diff --git a/doc/html/man/infocmp.1m.html b/doc/html/man/infocmp.1m.html
index 67a9489f..6442c1a6 100644
--- a/doc/html/man/infocmp.1m.html
+++ b/doc/html/man/infocmp.1m.html
@@ -1,7 +1,7 @@
@@ -46,21 +46,18 @@
-
-
+
infocmp - compare or print out terminfo descriptions
-
-
- infocmp [-1CDEFGIKLTUVcdegilnpqrtux]
- [-v n] [-s d| i| l| c] [-R subset]
+
+ infocmp [-1CDEFGIKLTUVWcdegilnpqrtux]
+ [-v n] [-s d| i| l| c] [-Q n] [-R subset]
[-w width] [-A directory] [-B directory]
[termname...]
-
-
+
infocmp can be used to compare a binary terminfo entry
with other terminfo entries, rewrite a terminfo descrip-
tion to take advantage of the use= terminfo field, or
@@ -70,42 +67,57 @@
fields, followed by the string fields.
-
-
+
If no options are specified and zero or one termnames are
specified, the -I option will be assumed. If more than
one termname is specified, the -d option will be assumed.
-
-
+
infocmp compares the terminfo description of the first
terminal termname with each of the descriptions given by
the entries for the other terminal's termnames. If a
capability is defined for only one of the terminals, the
- value returned will depend on the type of the capability:
- F for boolean variables, -1 for integer variables, and
- NULL for string variables.
+ value returned depends on the type of the capability:
- The -d option produces a list of each capability that is
- different between two entries. This option is useful to
- show the difference between two entries, created by dif-
- ferent people, for the same or similar terminals.
+ o F for missing boolean variables
- The -c option produces a list of each capability that is
- common between two or more entries. Capabilities that are
- not set are ignored. This option can be used as a quick
- check to see if the -u option is worth using.
+ o NULL for missing integer or string variables
- The -n option produces a list of each capability that is
- in none of the given entries. If no termnames are given,
- the environment variable TERM will be used for both of the
- termnames. This can be used as a quick check to see if
- anything was left out of a description.
+ Use the -q option to show the distinction between absent
+ and cancelled capabilities.
+ These options produce a list which you can use to compare
+ two or more terminal descriptions:
-
-
+ -d produces a list of each capability that is different
+ between two entries. Each item in the list shows ":"
+ after the capability name, followed by the capability
+ values, separated by a comma.
+
+ -c produces a list of each capability that is common
+ between two or more entries. Missing capabilities
+ are ignored. Each item in the list shows "=" after
+ the capability name, followed by the capability
+ value.
+
+ The -u option provides a related output, showing the
+ first terminal description rewritten to use the sec-
+ ond as a building block via the "use=" clause.
+
+ -n produces a list of each capability that is in none of
+ the given entries. Each item in the list shows "!"
+ before the capability name.
+
+ Normally only the conventional capabilities are
+ shown. Use the -x option to add the BSD-compatibil-
+ ity capabilities (names prefixed with "OT").
+
+ If no termnames are given, infocmp uses the environ-
+ ment variable TERM for each of the termnames.
+
+
+
The -I, -L, and -C options will produce a source listing
for each terminal named.
@@ -127,7 +139,7 @@
For best results when converting to termcap format, you
should use both -C and -r. Normally a termcap description
- is limited to 1023 bytes. infocmp trims away less essen-
+ is limited to 1023 bytes. infocmp trims away less essen-
tial 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 -T
@@ -138,7 +150,7 @@
All padding information for strings will be collected
together and placed at the beginning of the string where
termcap expects it. Mandatory padding (padding informa-
- tion with a trailing '/') will become optional.
+ tion with a trailing "/") will become optional.
All termcap variables no longer supported by terminfo, but
which are derivable from other terminfo variables, will be
@@ -165,6 +177,8 @@
equivalents, and some terminal types which commonly have
such sequences, are:
+
+
terminfo termcap Representative Terminals
---------------------------------------------------------------
%p1%c %. adm
@@ -175,8 +189,7 @@
%p2 is printed before %p1 %r hp
-
-
+
The -u option produces a terminfo source description of
the first terminal termname which is relative to the sum
of the descriptions given by the entries for the other
@@ -223,7 +236,7 @@
needed.
Changing Databases [-A directory] [-B directory]
- Like other ncurses utilities, infocmp looks for the termi-
+ Like other ncurses utilities, infocmp looks for the termi-
nal descriptions in several places. You can use the TER-
MINFO and TERMINFO_DIRS environment variables to override
the compiled-in default list of places to search (see
@@ -245,8 +258,7 @@
ated by different people.
-
-
+
-0 causes the fields to be printed on one line, without
wrapping.
@@ -305,24 +317,29 @@
rather than their decimal equivalents.
-i Analyze the initialization (is1, is2, is3), and reset
- (rs1, rs2, rs3), strings in the entry. 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 spe-
- cial 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 recog-
- nized actions translated into {}-bracketed descrip-
- tions. Here is a list of the DEC/ANSI special
- sequences recognized: i.
+ (rs1, rs2, rs3), strings in the entry, as well as
+ those used for starting/stopping cursor-positioning
+ mode (smcup, rmcup) as well as starting/stopping
+ keymap mode (smkx, rmkx).
+
+ 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 print-
+ able expansion of the capability string with sections
+ matching recognized actions translated into {}-brack-
+ eted descriptions.
+
+ Here is a list of the DEC/ANSI special sequences rec-
+ ognized:
Action Meaning
-----------------------------------------
RIS full reset
-
SC save cursor
RC restore cursor
LL home-down
@@ -359,37 +376,60 @@
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 `+' (turn on) or
- `-' (turn off).
+ All but NORMAL may be prefixed with
- An SGR0 designates an empty highlight sequence
+ o "+" (turn on) or
+
+ o "-" (turn off).
+
+ An SGR0 designates an empty highlight sequence
(equivalent to {SGR:NORMAL}).
-l Set output format to terminfo.
-p Ignore padding specifications when comparing strings.
- -q Make the comparison listing shorter by omitting sub-
- headings, and using "-" for absent capabilities, "@"
- for canceled rather than "NULL".
+ -Q n Rather than show source in terminfo (text) format,
+ print the compiled (binary) format in hexadecimal or
+ base64 form, depending on the option's value:
+
+ 1 hexadecimal
+
+ 2 base64
+
+ 3 hexadecimal and base64
+
+ -q This makes the output a little shorter:
+
+ o Make the comparison listing shorter by omitting
+ subheadings, and using "-" for absent capabili-
+ ties, "@" for canceled rather than "NULL".
+
+ o However, show differences between absent and can-
+ celled capabilities.
+
+ o Omit the "Reconstructed from" comment for source
+ listings.
-Rsubset
- 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
+ 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 incompati-
- ble with SVr4/XSI. Available terminfo subsets are
- "SVr1", "Ultrix", "HP", and "AIX"; see terminfo(5)
- for details. You can also choose the subset "BSD"
- which selects only capabilities with termcap equiva-
- lents recognized by 4.4BSD.
+ ble with SVr4/XSI.
+
+ Available terminfo subsets are "SVr1", "Ultrix",
+ "HP", and "AIX"; see terminfo(5) for details. You
+ can also choose the subset "BSD" which selects only
+ capabilities with termcap equivalents recognized by
+ 4.4BSD.
-s [d|i|l|c]
- The -s option sorts the fields within each type
+ The -s option sorts the fields within each type
according to the argument below:
- d leave fields in the order that they are stored
+ d leave fields in the order that they are stored
in the terminfo database.
i sort by terminfo name.
@@ -399,33 +439,40 @@
c sort by the termcap name.
If the -s option is not given, the fields printed out
- will be sorted alphabetically by the terminfo name
+ will be sorted alphabetically by the terminfo name
within each type, except in the case of the -C or the
-L options, which cause the sorting to be done by the
- termcap name or the long C variable name, respec-
+ termcap name or the long C variable name, respec-
tively.
- -T eliminates size-restrictions on the generated text.
+ -T 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).
-t tells tic to discard commented-out capabilities.
- Normally when translating from terminfo to termcap,
+ Normally when translating from terminfo to termcap,
untranslatable capabilities are commented-out.
- -U tells infocmp 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 infocmp makes
+ -U tells infocmp 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 infocmp makes
to fill in missing data.
-V reports the version of ncurses which was used in this
program, and exits.
- -v n prints out tracing information on standard error as
- the program runs. Higher values of n induce greater
- verbosity.
+ -v n prints out tracing information on standard error as
+ the program runs.
+
+ The optional parameter n 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.
+
+ -W By itself, the -w option will not force long strings
+ to be wrapped. Use the -W option to do this.
-w width
changes the output to width characters.
@@ -435,41 +482,42 @@
can be loaded using the -x option of tic.
-
-
+
/usr/share/terminfo Compiled terminal description data-
base.
-
-
- The -0, -1, -E, -F, -G, -R, -T, -V, -a, -e, -f, -g, -i,
- -l, -p, -q and -t options are not supported in SVr4
+
+ The -0, -1, -E, -F, -G, -Q, -R, -T, -V, -a, -e, -f, -g,
+ -i, -l, -p, -q and -t options are not supported in SVr4
curses.
- The -r option's notion of `termcap' capabilities is System
+ SVr4 infocmp does not distinguish between absent and can-
+ celled capabilities. Also, it shows missing integer capa-
+ bilities as -1 (the internal value used to represent miss-
+ ing integers). This implementation shows those as "NULL",
+ for consistency with missing strings.
+
+ The -r 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 -r
-RBSD.
-
-
+
The -F option of infocmp(1m) should be a toe(1m) mode.
-
-
+
captoinfo(1m), infotocap(1m), tic(1m), toe(1m),
curses(3x), terminfo(5).
http://invisible-island.net/ncurses/tctest.html
- This describes ncurses version 5.9 (patch 20150516).
+ This describes ncurses version 6.0 (patch 20170304).
-
-
+
Eric S. Raymond <esr@snark.thyrsus.com> and
Thomas E. Dickey <dickey@invisible-island.net>