X-Git-Url: http://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Finfocmp.1m.html;h=efd6abc7c89d7a1ec9001d8e80e6eb9d8e7a3592;hp=98354c28da1215813adeea77d69614cdc2357dba;hb=32f9f5f12cd9159261f9db228461049e8c770404;hpb=77afe78361875f531dc2bf8d73f2e781c8e76176 diff --git a/doc/html/man/infocmp.1m.html b/doc/html/man/infocmp.1m.html index 98354c28..efd6abc7 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 +69,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 +93,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 +113,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 +125,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 +146,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 +174,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 +223,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 @@ -266,19 +305,25 @@ 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 ----------------------------------------- @@ -310,7 +355,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 +367,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. @@ -340,11 +384,13 @@ 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 @@ -397,37 +443,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 20100109). + http://invisible-island.net/ncurses/tctest.html + + This describes ncurses version 6.0 (patch 20150718).-AUTHOR
+AUTHOR
Eric S. Raymond <esr@snark.thyrsus.com> and Thomas E. Dickey <dickey@invisible-island.net> @@ -435,10 +484,25 @@ infocmp(1m)-
- -Man(1) output converted with -man2html - +