diff options
Diffstat (limited to 'ncurses-5.2/doc/html/man/infocmp.1m.html')
-rw-r--r-- | ncurses-5.2/doc/html/man/infocmp.1m.html | 406 |
1 files changed, 406 insertions, 0 deletions
diff --git a/ncurses-5.2/doc/html/man/infocmp.1m.html b/ncurses-5.2/doc/html/man/infocmp.1m.html new file mode 100644 index 0000000..5f77495 --- /dev/null +++ b/ncurses-5.2/doc/html/man/infocmp.1m.html @@ -0,0 +1,406 @@ +<HTML> +<BODY> +<PRE> +<!-- Manpage converted by man2html 3.0.1 --> + +</PRE> +<H2>NAME</H2><PRE> + <B>infocmp</B> - compare or print out <I>terminfo</I> descriptions + + +</PRE> +<H2>SYNOPSIS</H2><PRE> + <B>infocmp</B> [<B>-dceEGgnpqrILCuV1</B>] [<B>-v</B> <I>n</I>] [<B>-s</B> <B>d</B>| <B>i</B>| <B>l</B>| <B>c</B>] + [<B>-w</B> <I>width</I>] [<B>-A</B> <I>directory</I>] [<B>-B</B> <I>directory</I>] + [<I>termname</I>...] + + +</PRE> +<H2>DESCRIPTION</H2><PRE> + <B>infocmp</B> can be used to compare a binary <B>terminfo</B> entry + with other terminfo entries, rewrite a <B>terminfo</B> descrip- + tion to take advantage of the <B>use=</B> terminfo field, or + print out a <B>terminfo</B> description from the binary file + (<B>term</B>) in a variety of formats. In all cases, the boolean + fields will be printed first, followed by the numeric + fields, followed by the string fields. + + <B>Default</B> <B>Options</B> + If no options are specified and zero or one <I>termnames</I> are + specified, the <B>-I</B> option will be assumed. If more than + one <I>termname</I> is specified, the <B>-d</B> option will be assumed. + + <B>Comparison</B> <B>Options</B> <B>[-d]</B> <B>[-c]</B> <B>[-n]</B> + <B>infocmp</B> compares the <B>terminfo</B> description of the first + terminal <I>termname</I> with each of the descriptions given by + the entries for the other terminal's <I>termnames</I>. If a + capability is defined for only one of the terminals, the + value returned will depend on the type of the capability: + <B>F</B> for boolean variables, <B>-1</B> for integer variables, and + <B>NULL</B> for string variables. + + The <B>-d</B> 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. + + The <B>-c</B> 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 <B>-u</B> option is worth using. + + The <B>-n</B> option produces a list of each capability that is + in neither entry. If no <I>termnames</I> are given, the environ- + ment variable <B>TERM</B> will be used for both of the <I>termnames</I>. + This can be used as a quick check to see if anything was + left out of a description. + + <B>Source</B> <B>Listing</B> <B>Options</B> <B>[-I]</B> <B>[-L]</B> <B>[-C]</B> <B>[-r]</B> + The <B>-I</B>, <B>-L</B>, and <B>-C</B> options will produce a source listing + for each terminal named. + + <B>-I</B> use the <B>terminfo</B> names + <B>-L</B> use the long C variable name listed in <<B>term.h</B>> + + <B>-C</B> use the <B>termcap</B> names + <B>-r</B> when using <B>-C</B>, put out all capabilities in <B>termcap</B> form + + If no <I>termnames</I> are given, the environment variable <B>TERM</B> + will be used for the terminal name. + + The source produced by the <B>-C</B> option may be used directly + as a <B>termcap</B> entry, but not all parameterized strings can + be changed to the <B>termcap</B> format. <B>infocmp</B> will attempt to + convert most of the parameterized information, and any- + thing not converted will be plainly marked in the output + and commented out. These should be edited by hand. + + All padding information for strings will be collected + together and placed at the beginning of the string where + <B>termcap</B> expects it. Mandatory padding (padding informa- + tion with a trailing '/') will become optional. + + All <B>termcap</B> variables no longer supported by <B>terminfo</B>, but + which are derivable from other <B>terminfo</B> variables, will be + output. Not all <B>terminfo</B> capabilities will be translated; + only those variables which were part of <B>termcap</B> will nor- + mally be output. Specifying the <B>-r</B> option will take off + this restriction, allowing all capabilities to be output + in <I>termcap</I> form. + + Note that because padding is collected to the beginning of + the capability, not all capabilities are output. Manda- + tory padding is not supported. Because <B>termcap</B> strings + are not as flexible, it is not always possible to convert + a <B>terminfo</B> string capability into an equivalent <B>termcap</B> + format. A subsequent conversion of the <B>termcap</B> file back + into <B>terminfo</B> format will not necessarily reproduce the + original <B>terminfo</B> source. + + Some common <B>terminfo</B> parameter sequences, their <B>termcap</B> + equivalents, and some terminal types which commonly have + such sequences, are: + + <B>terminfo</B> <B>termcap</B> Representative Terminals + --------------------------------------------------------------- + <B>%p1%c</B> <B>%.</B> adm + <B>%p1%d</B> <B>%d</B> hp, ANSI standard, vt100 + <B>%p1%'x'%+%c</B> <B>%+x</B> concept + <B>%i</B> <B>%i</B>q ANSI standard, vt100 + <B>%p1%?%'x'%>%t%p1%'y'%+%;</B> <B>%>xy</B> concept + <B>%p2</B> is printed before <B>%p1</B> <B>%r</B> hp + + <B>Use=</B> <B>Option</B> <B>[-u]</B> + The <B>-u</B> option produces a <B>terminfo</B> source description of + the first terminal <I>termname</I> which is relative to the sum + of the descriptions given by the entries for the other + terminals <I>termnames</I>. It does this by analyzing the dif- + ferences between the first <I>termname</I> and the other + <I>termnames</I> and producing a description with <B>use=</B> 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 <B>infocmp</B> will + show what can be done to change one description to be rel- + ative to the other. + + A capability will get printed with an at-sign (@) if it no + longer exists in the first <I>termname</I>, but one of the other + <I>termname</I> entries contains a value for it. A capability's + value gets printed if the value in the first <I>termname</I> is + not found in any of the other <I>termname</I> entries, or if the + first of the other <I>termname</I> entries that has this capabil- + ity gives a different value for the capability than that + in the first <I>termname</I>. + + The order of the other <I>termname</I> entries is significant. + Since the terminfo compiler <B>tic</B> does a left-to-right scan + of the capabilities, specifying two <B>use=</B> entries that con- + tain differing entries for the same capabilities will pro- + duce different results depending on the order that the + entries are given in. <B>infocmp</B> will flag any such incon- + sistencies between the other <I>termname</I> entries as they are + found. + + Alternatively, specifying a capability <I>after</I> a <B>use=</B> entry + that contains that capability will cause the second speci- + fication to be ignored. Using <B>infocmp</B> to recreate a + description can be a useful check to make sure that every- + thing was specified correctly in the original source + description. + + Another error that does not cause incorrect compiled + files, but will slow down the compilation time, is speci- + fying extra <B>use=</B> fields that are superfluous. <B>infocmp</B> + will flag any other <I>termname</I> <I>use=</I> fields that were not + needed. + + <B>Changing</B> <B>Databases</B> <B>[-A</B> <I>directory</I>] [-B <I>directory</I>] + The location of the compiled <B>terminfo</B> database is taken + from the environment variable <B>TERMINFO</B> . If the variable + is not defined, or the terminal is not found in that loca- + tion, the system <B>terminfo</B> database, in <B>/usr/share/ter-</B> + <B>minfo</B>, will be used. The options <B>-A</B> and <B>-B</B> may be used to + override this location. The <B>-A</B> option will set <B>TERMINFO</B> + for the first <I>termname</I> and the <B>-B</B> option will set <B>TERMINFO</B> + for the other <I>termnames</I>. 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. + + <B>Other</B> <B>Options</B> <B>[-s</B> <B>d|i|l|c]</B> <B>[-1FTVefip]</B> <B>[-Rsubset]</B> <B>[-v</B> <I>n</I>] [-w + <I>width</I>] + The <B>-s</B> option sorts the fields within each type according + to the argument below: + + <B>d</B> leave fields in the order that they are stored in the + <I>terminfo</I> database. + + <B>i</B> sort by <I>terminfo</I> name. + + <B>l</B> sort by the long C variable name. + + <B>c</B> sort by the <I>termcap</I> name. + + If the <B>-s</B> option is not given, the fields printed out + will be sorted alphabetically by the <B>terminfo</B> name + within each type, except in the case of the <B>-C</B> or the + <B>-L</B> options, which cause the sorting to be done by the + <B>termcap</B> name or the long C variable name, respec- + tively. + + <B>-1</B> 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. + + <B>-F</B> compare terminfo files. This assumes that two fol- + lowing arguments are filenames. The files are + searched for pairwise matches between entries, with + two entries considered to match if any of their names + do. The report printed to standard output lists + entries with no matches in the other file, and + entries with more than one match. For entries with + exactly one match it includes a difference report. + Normally, to reduce the volume of the report, use + references are not resolved before looking for dif- + ferences, but resolution can be forced by also speci- + fying <B>-r</B>. + + <B>-G</B> Display constant literals in decimal form rather than + their character equivalents. + + <B>-a</B> tells <B>infocmp</B> to retain commented-out capabilities + rather than discarding them. Capabilities are com- + mented by prefixing them with a period. + + <B>-q</B> Make the comparison listing shorter by omitting sub- + headings, and using "-" for absent capabilities, "@" + for canceled rather than "NULL". + + <B>-R</B><I>subset</I> + 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 <B><A HREF="terminfo.5.html">terminfo(5)</A></B> + for details. You can also choose the subset "BSD" + which selects only capabilities with termcap equiva- + lents recognized by 4.4BSD. + + <B>-T</B> 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). + + <B>-V</B> reports the version of ncurses which was used in this + program, and exits. + + <B>-e</B> Dump the capabilities of the given terminal as a C + initializer for a TERMTYPE structure (the terminal + capability structure in the <B><term.h></B>). This option + is useful for preparing versions of the curses + library hardwired for a given terminal type. + + <B>-E</B> Dump the capabilities of the given terminal as + tables, needed in the C initializer for a TERMTYPE + structure (the terminal capability structure in the + <B><term.h></B>). This option is useful for preparing ver- + sions of the curses library hardwired for a given + terminal type. The tables are all declared static, + and are named according to the type and the name of + the corresponding terminal entry. + + Before ncurses 5.0, the split between the <B>-e</B> and <B>-E</B> + options was not needed; but support for extended + names required making the arrays of terminal capabil- + ities separate from the TERMTYPE structure. + + <B>-f</B> Display complex terminfo strings which contain + if/then/else/endif expressions indented for readabil- + ity. + + <B>-g</B> Display constant character literals in quoted form + rather than their decimal equivalents. + + <B>-i</B> Analyze the initialization (<B>is1</B>, <B>is2</B>, <B>is3</B>), and reset + (<B>rs1</B>, <B>rs2</B>, <B>rs3</B>), 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 + descriptions. Here is a list of the DEC/ANSI special + sequences recognized: + + Action Meaning + ----------------------------------------- + RIS full reset + SC save cursor + RC restore cursor + LL home-down + RSR reset scroll region + + ISO DEC G0 enable DEC graphics for G0 + ISO UK G0 enable UK chars for G0 + ISO US G0 enable US chars for G0 + ISO DEC G1 enable DEC graphics for G1 + ISO UK G1 enable UK chars for G1 + ISO US G1 enable US chars for G1 + + DECPAM application keypad mode + DECPNM normal keypad mode + DECANSI enter ANSI mode + + 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 + DEC[+-]AWM wraparound mode + DEC[+-]ARM auto-repeat mode + + 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). + + An SGR0 designates an empty highlight sequence + (equivalent to {SGR:NORMAL}). + + <B>-p</B> Ignore padding specifications when comparing strings. + + <B>-v</B> <I>n</I> prints out tracing information on standard error as + the program runs. Higher values of n induce greater + verbosity. + + <B>-w</B> <I>width</I> + changes the output to <I>width</I> characters. + + +</PRE> +<H2>FILES</H2><PRE> + /usr/share/terminfo Compiled terminal description + database. + + + +</PRE> +<H2>EXTENSIONS</H2><PRE> + The <B>-E</B>, <B>-F</B>, <B>-G</B>, <B>-R</B>, <B>-T</B>, <B>-V</B>, <B>-a</B>, <B>-e</B>, <B>-f</B>, <B>-g</B>, <B>-i</B>, <B>-p</B>, and <B>-q</B> + options are not supported in SVr4 curses. + + The <B>-r</B> 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. + + +</PRE> +<H2>BUGS</H2><PRE> + The -F option of <B><A HREF="infocmp.1m.html">infocmp(1m)</A></B> should be a <B><A HREF="toe.1m.html">toe(1m)</A></B> mode. + + +</PRE> +<H2>SEE ALSO</H2><PRE> + <B><A HREF="infocmp.1m.html">infocmp(1m)</A></B>, <B><A HREF="captoinfo.1m.html">captoinfo(1m)</A></B>, <B><A HREF="infotocap.1m.html">infotocap(1m)</A></B>, <B><A HREF="tic.1m.html">tic(1m)</A></B>, + <B><A HREF="toe.1m.html">toe(1m)</A></B>, <B><A HREF="ncurses.3x.html">curses(3x)</A></B>, <B><A HREF="terminfo.5.html">terminfo(5)</A></B>. + + +</PRE> +<H2>AUTHOR</H2><PRE> + Eric S. Raymond <esr@snark.thyrsus.com> and Thomas E. + Dickey <dickey@herndon4.his.com> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +</PRE> +<HR> +<ADDRESS> +Man(1) output converted with +<a href="http://www.oac.uci.edu/indiv/ehood/man2html.html">man2html</a> +</ADDRESS> +</BODY> +</HTML> |