X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Finfocmp.1m.html;h=d40cc4a0f91c9baa37339b629d266826142fedcc;hp=033b50449142da91f3db777f7209cd7f69bf3850;hb=c6cfd97b8beaf0f6deafbf8aac7281cf6aa7f012;hpb=71c0306f0824ef2b10c4c5813fb003db48f3012e diff --git a/doc/html/man/infocmp.1m.html b/doc/html/man/infocmp.1m.html index 033b5044..d40cc4a0 100644 --- a/doc/html/man/infocmp.1m.html +++ b/doc/html/man/infocmp.1m.html @@ -1,8 +1,7 @@ - +
+ +- infocmp(1m) infocmp(1m)-
+NAME
infocmp - compare or print out terminfo descriptions-SYNOPSIS
- infocmp [-1CEFGILTUVcdegilnpqrtux] +SYNOPSIS
+ infocmp [-1CDEFGIKLTUVcdegilnpqrtux] [-v n] [-s d| i| l| c] [-R subset] [-w width] [-A directory] [-B directory] [termname...]-DESCRIPTION
+DESCRIPTION
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 +70,16 @@ fields will be printed first, followed by the numeric fields, followed by the string fields. - Default Options + ++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] + ++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 @@ -89,17 +94,19 @@ ferent people, for the same or similar terminals. The -c option produces a list of each capability that is - common between two 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. + 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 neither entry. If no termnames are given, the environ- - ment 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. + 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] ++Source Listing Options [-I] [-L] [-C] [-r]
The -I, -L, and -C options will produce a source listing for each terminal named. @@ -107,6 +114,7 @@ -L use the long C variable name listed in <term.h> -C use the termcap names -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. @@ -118,6 +126,16 @@ thing not converted will be plainly marked in the output and commented out. These should be edited by hand. + 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- + 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 + option. More often however, you must help the termcap + implementation, and trim excess whitespace (use the -0 + option for that). + 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- @@ -129,7 +147,11 @@ only those variables which were part of termcap will nor- mally be output. Specifying the -r option will take off this restriction, allowing all capabilities to be output - in termcap form. + in termcap form. Normally you would use both the -C and + -r options. The actual format used incorporates some + improvements for escaped characters from terminfo format. + For a stricter BSD-compatible translation, use the -K + option rather than -C. Note that because padding is collected to the beginning of the capability, not all capabilities are output. Manda- @@ -153,7 +175,9 @@ %p1%?%'x'%>%t%p1%'y'%+%; %>xy concept %p2 is printed before %p1 %r hp - Use= Option [-u] + ++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 @@ -200,28 +224,44 @@ needed. Changing Databases [-A directory] [-B directory] - The location of the compiled terminfo database is taken - from the environment variable TERMINFO . If the variable - is not defined, or the terminal is not found in that loca- - tion, the system terminfo database, in /usr/share/ter- - minfo, will be used. The options -A and -B may be used to - override this location. The -A option will set TERMINFO - for the first termname and the -B option will set TERMINFO - for the other termnames. With this, it is possible to - compare descriptions for a terminal with the same name - located in two different databases. This is useful for - comparing descriptions for the same terminal created by - different people. - - Other Options - -1 causes the fields to be printed out one to a line. - Otherwise, the fields will be printed several to a + 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 + curses(3x) for details). + + You can also use the options -A and -B to override the + list of places to search when comparing terminal descrip- + tions: + + o The -A option sets the location for the first termname + + o The -B option sets the location for the other + termnames. + + Using these options, it is possible to compare descrip- + tions for a terminal with the same name located in two + different databases. For instance, you can use this fea- + 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. + + -1 causes the fields to be printed out one to a line. + Otherwise, the fields will be printed several to a line to a maximum width of 60 characters. - -a tells infocmp to retain commented-out capabilities - rather than discarding them. Capabilities are com- + -a tells infocmp to retain commented-out capabilities + rather than discarding them. Capabilities are com- mented by prefixing them with a period. + -D tells infocmp to print the database locations that it + knows about, and exit. + -E Dump the capabilities of the given terminal as tables, needed in the C initializer for a TERMTYPE structure (the terminal capability structure in the @@ -283,6 +323,7 @@ Action Meaning ----------------------------------------- RIS full reset + SC save cursor RC restore cursor LL home-down @@ -310,7 +351,6 @@ DEC[+-]CKM application cursor keys DEC[+-]ANM set VT52 mode DEC[+-]COLM 132-column mode - DEC[+-]SCLM smooth scroll DEC[+-]SCNM reverse video mode DEC[+-]OM origin mode @@ -323,8 +363,8 @@ All but NORMAL may be prefixed with `+' (turn on) or `-' (turn off). - An SGR0 designates an empty highlight sequence (equivalent - to {SGR:NORMAL}). + An SGR0 designates an empty highlight sequence + (equivalent to {SGR:NORMAL}). -l Set output format to terminfo. @@ -397,37 +437,40 @@-FILES
+FILES
/usr/share/terminfo Compiled terminal description data- base.-EXTENSIONS
- The -E, -F, -G, -R, -T, -V, -a, -e, -f, -g, -i, -l, -p, -q - and -t options are not supported in SVr4 curses. +EXTENSIONS
+ 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.-BUGS
+BUGS
The -F option of infocmp(1m) should be a toe(1m) mode.-SEE ALSO
- captoinfo(1m), infotocap(1m), tic(1m), toe(1m), +SEE ALSO
+ captoinfo(1m), infotocap(1m), tic(1m), toe(1m), curses(3x), terminfo(5). - This describes ncurses version 5.7 (patch 20100731). + http://invisible-island.net/ncurses/tctest.html + + This describes ncurses version 5.9 (patch 20150215).-AUTHOR
+AUTHOR
Eric S. Raymond <esr@snark.thyrsus.com> and Thomas E. Dickey <dickey@invisible-island.net> @@ -435,10 +478,25 @@ infocmp(1m)-
- -Man(1) output converted with -man2html - +