X-Git-Url: http://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Finfocmp.1m.html;h=979bfddc86f2074782a9e5f6bfe5b6089cf277b9;hp=443938b48cda7a2d29f9547efc2415c4da1dae69;hb=56f1e8cd80dfb926f74e1739bf969489b0cfa56f;hpb=b0b1980be11bba618d84beb8b30ac94e2c820602 diff --git a/doc/html/man/infocmp.1m.html b/doc/html/man/infocmp.1m.html index 443938b4..979bfddc 100644 --- a/doc/html/man/infocmp.1m.html +++ b/doc/html/man/infocmp.1m.html @@ -1,8 +1,7 @@ - +
+ +- infocmp(1m) infocmp(1m) --
+
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 @@ -69,12 +66,14 @@ fields will be printed first, followed by the numeric fields, followed by the string fields. - Default Options + +
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. - Comparison Options [-d] [-c] [-n] + +
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 @@ -99,7 +98,8 @@ termnames. This can be used as a quick check to see if anything was left out of a description. - Source Listing Options [-I] [-L] [-C] [-r] + +
The -I, -L, and -C options will produce a source listing for each terminal named. @@ -168,7 +168,8 @@ %p1%?%'x'%>%t%p1%'y'%+%; %>xy concept %p2 is printed before %p1 %r hp - Use= Option [-u] + +
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 @@ -236,7 +237,8 @@ ture for comparing descriptions for the same terminal cre- ated by different people. - Other Options + +
-0 causes the fields to be printed on one line, without wrapping. @@ -295,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 @@ -359,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. @@ -389,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 20141220). + This describes ncurses version 6.0 (patch 20160521). --
+
Eric S. Raymond <esr@snark.thyrsus.com> and Thomas E. Dickey <dickey@invisible-island.net> @@ -467,7 +486,25 @@ infocmp(1m)-