X-Git-Url: http://ncurses.scripts.mit.edu/?a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Finfocmp.1m.html;fp=doc%2Fhtml%2Fman%2Finfocmp.1m.html;h=6b1016e756dd9b430e135482f9d06a03b123f61b;hb=084e3b44fc1c904d5ab941da55f47a237cb15766;hp=30dd3e8829b84d91ce428f672f295d6b270ad01b;hpb=89d66edde5b9525fff1f4343470231344d1ff2c6;p=ncurses.git diff --git a/doc/html/man/infocmp.1m.html b/doc/html/man/infocmp.1m.html index 30dd3e88..6b1016e7 100644 --- a/doc/html/man/infocmp.1m.html +++ b/doc/html/man/infocmp.1m.html @@ -28,19 +28,19 @@ * sale, use or other dealings in this Software without prior written * * authorization. * **************************************************************************** - * @Id: infocmp.1m,v 1.97 2023/10/14 19:26:28 tom Exp @ + * @Id: infocmp.1m,v 1.99 2023/11/25 17:10:25 tom Exp @ -->
-infocmp(1m) User commands infocmp(1m) @@ -52,10 +52,10 @@
- infocmp [-1CDEFGIKLTUVWcdegilnpqrtux] + infocmp [-1cCdDeEFgGiIKlLnpqrtTuUVWx] [-v n] [-s d| i| l| c] [-Q n] [-R subset] [-w width] [-A directory] [-B directory] - [termname...] + [terminal-type ...]
@@ -68,17 +68,17 @@
- 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. + If no options are specified and zero or one terminal-types are + specified, the -I option will be assumed. If more than one terminal- + type 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 depends on the type of the - capability: + terminal-type with each of the descriptions given by the entries for + the other terminal's terminal-types. If a capability is defined for + only one of the terminals, the value returned depends on the type of + the capability: o F for missing boolean variables @@ -111,8 +111,8 @@ option to add the BSD-compatibility capabilities (names prefixed with "OT"). - If no termnames are given, infocmp uses the environment variable - TERM for each of the termnames. + If no terminal-types are given, infocmp uses the environment + variable TERM for each of the terminal-types.
@@ -125,8 +125,8 @@ -r when using -C, put out all capabilities in termcap form -K modifies the -C option, improving BSD-compatibility. - If no termnames are given, the environment variable TERM will be used - for the terminal name. + If no terminal-types are given, the environment variable TERM will be + used for the terminal name. The source produced by the -C option may be used directly as a termcap entry, but not all parameterized strings can be changed to the termcap @@ -180,29 +180,31 @@
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 terminals termnames. It does this - by analyzing the differences between the first termname and the other - termnames and producing a description with use= fields for the other - terminals. In this manner, it is possible to retrofit generic terminfo - entries into a terminal's description. Or, if two similar terminals - exist, but were coded at different times or by different people so that - each description is a full description, using infocmp will show what - can be done to change one description to be relative to the other. + terminal terminal-type which is relative to the sum of the descriptions + given by the entries for the other terminal-types. It does this by + analyzing the differences between the first terminal-types and the + other terminal-types and producing a description with use= fields for + the other terminals. In this manner, it is possible to retrofit + generic terminfo entries into a terminal's description. Or, if two + similar terminals exist, but were coded at different times or by + different people so that each description is a full description, using + infocmp will show what can be done to change one description to be + relative to the other. A capability will be printed with an at-sign (@) if it no longer exists - in the first termname, but one of the other termname entries contains a - value for it. A capability's value will be printed if the value in the - first termname is not found in any of the other termname entries, or if - the first of the other termname entries that has this capability gives - a different value for the capability than that in the first termname. - - The order of the other termname entries is significant. Since the + in the first terminal-type, but one of the other terminal-type entries + contains a value for it. A capability's value will be printed if the + value in the first terminal-type is not found in any of the other + terminal-type entries, or if the first of the other terminal-type + entries that has this capability gives a different value for the + capability than that in the first terminal-type. + + The order of the other terminal-type entries is significant. Since the terminfo compiler tic does a left-to-right scan of the capabilities, specifying two use= entries that contain differing entries for the same capabilities will produce different results depending on the order that the entries are given in. infocmp will flag any such inconsistencies - between the other termname entries as they are found. + between the other terminal-type entries as they are found. Alternatively, specifying a capability after a use= entry that contains that capability will cause the second specification to be ignored. @@ -212,8 +214,8 @@ Another error that does not cause incorrect compiled files, but will slow down the compilation time, is specifying extra use= fields that - are superfluous. infocmp will flag any other termname use= fields that - were not needed. + are superfluous. infocmp will flag any other terminal-type use= fields + that were not needed. Changing Databases [-A directory] [-B directory] Like other ncurses utilities, infocmp looks for the terminal @@ -225,9 +227,9 @@ You can also use the options -A and -B to override the list of places to search when comparing terminal descriptions: - o The -A option sets the location for the first termname + o The -A option sets the location for the first terminal-type - o The -B option sets the location for the other termnames. + o The -B option sets the location for the other terminal-types. Using these options, it is possible to compare descriptions for a terminal with the same name located in two different databases. For @@ -311,9 +313,8 @@ LL home-down RSR reset scroll region ----------------------------------------- - DECSTR soft reset (VT320) - + DECSTR soft reset (VT320) S7C1T 7-bit controls (VT220) ----------------------------------------- ISO DEC G0 enable DEC graphics for G0 @@ -457,7 +458,7 @@ -w width changes the output to width characters. - -x print information for user-defined capabilities (see user_caps(5). + -x print information for user-defined capabilities (see user_caps(5). These are extensions to the terminfo repertoire which can be loaded using the -x option of tic. @@ -467,6 +468,26 @@ compiled terminal description database +
+ 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. + + SVr4 infocmp does not distinguish between absent and cancelled + capabilities. Also, it shows missing integer capabilities as -1 (the + internal value used to represent missing 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. + + +
+ X/Open Curses, Issue 7 (2009) provides a description of infocmp. It + does not mention the options used for converting to termcap format. + +
Although System V Release 2 provided a terminfo library, it had no documented tool for decompiling the terminal descriptions. Tony Hansen @@ -493,35 +514,15 @@ adapted from ncurses. -
- X/Open Curses, Issue 7 (2009) provides a description of infocmp. It - does not mention the options used for converting to termcap format. - - -
- 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. - - SVr4 infocmp does not distinguish between absent and cancelled - capabilities. Also, it shows missing integer capabilities as -1 (the - internal value used to represent missing 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. -
+
Eric S. Raymond <esr@snark.thyrsus.com> and Thomas E. Dickey <dickey@invisible-island.net> -
- The -F option of infocmp(1m) should be a toe(1m) mode. - -
captoinfo(1m), infotocap(1m), tic(1m), toe(1m), curses(3x), terminfo(5), user_caps(5) @@ -530,7 +531,7 @@ -ncurses 6.4 2023-10-14 infocmp(1m) +ncurses 6.4 2023-11-25 infocmp(1m)