X-Git-Url: https://ncurses.scripts.mit.edu/?a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Finfocmp.1m.html;h=26b750a7267a8e107eecadefdd48fc58837fb619;hb=8e397cccba0aad135cb9a8a353756f4273a7cdf6;hp=9d18c97b3495a4a51462b6995297ce8e28eb5dbc;hpb=02f02dcd4464143580e783ae32c822d8eb8cdcbf;p=ncurses.git diff --git a/doc/html/man/infocmp.1m.html b/doc/html/man/infocmp.1m.html index 9d18c97b..26b750a7 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. @@ -364,39 +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 equivalents recognized by + "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. @@ -406,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. @@ -442,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 6.0 (patch 20150808). + This describes ncurses version 6.0 (patch 20170429). --
+
Eric S. Raymond <esr@snark.thyrsus.com> and Thomas E. Dickey <dickey@invisible-island.net>