X-Git-Url: https://ncurses.scripts.mit.edu/?a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Finfocmp.1m.html;h=3f4d43f061166793796231a67c492eeebbf39187;hb=ce4803687b821efbc5fb2c5a5f06d69cd4dc2656;hp=443938b48cda7a2d29f9547efc2415c4da1dae69;hpb=b0b1980be11bba618d84beb8b30ac94e2c820602;p=ncurses.git diff --git a/doc/html/man/infocmp.1m.html b/doc/html/man/infocmp.1m.html index 443938b4..3f4d43f0 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] +
+ 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 @@ -69,37 +66,58 @@ 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 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. - - 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. - - 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. - - 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. - - Source Listing Options [-I] [-L] [-C] [-r] + value returned depends on the type of the capability: + + o F for missing boolean variables + + o NULL for missing integer or string variables + + 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. @@ -121,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 @@ -132,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 @@ -159,6 +177,8 @@ equivalents, and some terminal types which commonly have such sequences, are: + + terminfo termcap Representative Terminals --------------------------------------------------------------- %p1%c %. adm @@ -168,7 +188,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 @@ -215,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 @@ -236,7 +257,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 +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 @@ -349,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. @@ -389,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. @@ -425,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 20141220). + This describes ncurses version 6.0 (patch 20170218). --
+
Eric S. Raymond <esr@snark.thyrsus.com> and Thomas E. Dickey <dickey@invisible-island.net> @@ -467,7 +525,25 @@ infocmp(1m)-