X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Finfocmp.1m.html;h=2bacccb1a686bb7142490f2726016ebd6a2ef754;hp=67a9489f0ebcd39b59b659fe8fe14f68db120c21;hb=e2e9c09c48b19b24979cafb2d4864f538b5ddd1c;hpb=027d0c57c4c4d6690e8d8727888d3282dbe9aa86;ds=sidebyside diff --git a/doc/html/man/infocmp.1m.html b/doc/html/man/infocmp.1m.html index 67a9489f..2bacccb1 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] + [-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,15 +67,13 @@ 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 @@ -104,8 +99,7 @@ anything was left out of a description. --
+
The -I, -L, and -C options will produce a source listing for each terminal named. @@ -175,8 +169,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 @@ -245,8 +238,7 @@ ated by different people. --
+
-0 causes the fields to be printed on one line, without wrapping. @@ -305,24 +297,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 @@ -369,27 +366,44 @@ -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 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,77 +413,72 @@ 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 + -v n prints out tracing information on standard error as + the program runs. Higher values of n induce greater verbosity. -w width changes the output to width characters. - -x print information for user-defined capabilities. + -x print information for user-defined capabilities. These are extensions to the terminfo repertoire which 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, -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 - V Release 4's. Actual BSD curses versions will have a - more restricted set. To see only the 4.4BSD set, use -r + 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), +
+ 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 20160910). --
+
Eric S. Raymond <esr@snark.thyrsus.com> and Thomas E. Dickey <dickey@invisible-island.net>