X-Git-Url: http://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Finfocmp.1m.html;h=26b750a7267a8e107eecadefdd48fc58837fb619;hp=dccf241ce7b2eded7491711c44d2cafa87472786;hb=8e397cccba0aad135cb9a8a353756f4273a7cdf6;hpb=59c1a9740d123db3cecafe76e18f7848081a670b diff --git a/doc/html/man/infocmp.1m.html b/doc/html/man/infocmp.1m.html index dccf241c..26b750a7 100644 --- a/doc/html/man/infocmp.1m.html +++ b/doc/html/man/infocmp.1m.html @@ -1,7 +1,7 @@ @@ -51,7 +51,7 @@
- infocmp [-1CDEFGIKLTUVcdegilnpqrtux] + infocmp [-1CDEFGIKLTUVWcdegilnpqrtux] [-v n] [-s d| i| l| c] [-Q n] [-R subset] [-w width] [-A directory] [-B directory] [termname...] @@ -78,25 +78,43 @@ 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.
@@ -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 @@ -216,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 @@ -356,18 +376,21 @@ 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 + + o "+" (turn on) or - An SGR0 designates an empty highlight sequence + 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 n Rather than show source in terminfo (text) format, - print the compiled (binary) format in hexadecimal or + -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 @@ -378,10 +401,13 @@ -q This makes the output a little shorter: - o Make the comparison listing shorter by omitting - subheadings, and using "-" for absent capabili- + 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. @@ -438,13 +464,20 @@ program, and exits. -v n prints out tracing information on standard error as - the program runs. Higher values of n induce greater - verbosity. + 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. - -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. @@ -455,13 +488,19 @@
- 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 - V Release 4's. Actual BSD curses versions will have a - more restricted set. To see only the 4.4BSD set, use -r + 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. @@ -470,12 +509,12 @@
- 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 6.0 (patch 20160723). + This describes ncurses version 6.0 (patch 20170429).