src - FreeBSD source tree

diff options


context:
space:
mode:

author	Xin LI <delphij@FreeBSD.org>	2014-03-01 00:40:26 +0000
committer	Xin LI <delphij@FreeBSD.org>	2014-03-01 00:40:26 +0000
commit	cea297eb34d2361e79529034397465068ae34ecd (patch)
tree	fbc3775582ebd1e6f026931751cfab6c588b643c /doc/html/man/infocmp.1m.html
parent	6826a395a618014c4541ff6a654be0d3afb392a1 (diff)
download	src-cea297eb34d2361e79529034397465068ae34ecd.tar.gz src-cea297eb34d2361e79529034397465068ae34ecd.zip

Vendor import of ncurses 5.9 20140222 snapshot.vendor/ncurses/5.9-20140222

Notes

Notes: svn path=/vendor/ncurses/dist/; revision=262639 svn path=/vendor/ncurses/5.9-20140222/; revision=262640; tag=vendor/ncurses/5.9-20140222

Diffstat (limited to 'doc/html/man/infocmp.1m.html')

-rw-r--r--

doc/html/man/infocmp.1m.html

284

1 files changed, 158 insertions, 126 deletions

diff --git a/doc/html/man/infocmp.1m.html b/doc/html/man/infocmp.1m.html
index 553e38548586..fc15a2b9eeca 100644
--- a/doc/html/man/infocmp.1m.html
+++ b/doc/html/man/infocmp.1m.html

@@ -1,8 +1,8 @@

-<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 2.0//EN">

+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN">

<!--

* t

****************************************************************************

* *

* Permission is hereby granted, free of charge, to any person obtaining a *

* copy of this software and associated documentation files (the *

@@ -28,7 +28,7 @@

* sale, use or other dealings in this Software without prior written *

* authorization. *

****************************************************************************

- * @Id: infocmp.1m,v 1.46 2010/12/04 18:40:45 tom Exp @

+ * @Id: infocmp.1m,v 1.53 2013/02/02 22:07:35 tom Exp @

-->

<HTML>

<HEAD>

@@ -53,7 +53,7 @@

</PRE>

<H2>SYNOPSIS</H2><PRE>

- infocmp [-1CEFGILTUVcdegilnpqrtux]

+ infocmp [-1CDEFGIKLTUVcdegilnpqrtux]

[-v n] [-s d| i| l| c] [-R subset]

[-w width] [-A directory] [-B directory]

[termname...]

@@ -72,76 +72,91 @@

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.

+ one termname is specified, the -d option will be assumed.

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

- 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

+ 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 will depend on the type of the capability:

+ F for boolean variables, -1 for integer variables, and

NULL for string variables.

- 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-

+ 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.

- 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.

+ 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.

- 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.

+ 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.

Source Listing Options [-I] [-L] [-C] [-r]

- The -I, -L, and -C options will produce a source listing

+ The -I, -L, and -C options will produce a source listing

for each terminal named.

-I use the terminfo names

-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

+ If no termnames 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

+ 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 format. infocmp will attempt to

- convert most of the parameterized information, and any-

- thing not converted will be plainly marked in the output

+ 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

- termcap expects it. Mandatory padding (padding informa-

+ 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-

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

output. Not all terminfo capabilities will be translated;

- 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.

+ 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. 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-

- tory padding is not supported. Because termcap strings

- are not as flexible, it is not always possible to convert

- a terminfo string capability into an equivalent termcap

- format. A subsequent conversion of the termcap file back

- into terminfo format will not necessarily reproduce the

+ the capability, not all capabilities are output. Manda-

+ tory padding is not supported. Because termcap strings

+ are not as flexible, it is not always possible to convert

+ a terminfo string capability into an equivalent termcap

+ format. A subsequent conversion of the termcap file back

+ into terminfo format will not necessarily reproduce the

original terminfo source.

- Some common terminfo parameter sequences, their termcap

- equivalents, and some terminal types which commonly have

+ Some common terminfo parameter sequences, their termcap

+ equivalents, and some terminal types which commonly have

such sequences, are:

terminfo termcap Representative Terminals

@@ -154,66 +169,77 @@

%p2 is printed before %p1 %r hp

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

- terminals termnames. It does this by analyzing the dif-

- ferences between the first termname and the other

+ 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 dif-

+ ferences 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

+ 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

+ 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 rel-

ative to the other.

A capability will get 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 gets printed if the value in the first termname is

- not found in any of the other termname entries, or if the

+ longer exists in the first termname, but one of the other

+ termname entries contains a value for it. A capability's

+ value gets 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 capabil-

- ity gives a different value for the capability than that

+ ity gives a different value for the capability than that

in the first termname.

- The order of the other termname entries is significant.

- Since the terminfo compiler tic does a left-to-right scan

+ The order of the other termname entries is significant.

+ Since the terminfo compiler tic does a left-to-right scan

of the capabilities, specifying two use= 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. infocmp will flag any such incon-

- sistencies between the other termname entries as they are

+ duce different results depending on the order that the

+ entries are given in. infocmp will flag any such incon-

+ sistencies between the other termname entries as they are

found.

- Alternatively, specifying a capability after a use= entry

+ Alternatively, specifying a capability after a use= entry

that contains that capability will cause the second speci-

- fication to be ignored. Using infocmp to recreate a

+ fication to be ignored. Using infocmp to recreate a

description can be a useful check to make sure that every-

- thing was specified correctly in the original source

+ 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 use= fields that are superfluous. infocmp

- will flag any other termname use= fields that were not

+ Another error that does not cause incorrect compiled

+ files, but will slow down the compilation time, is speci-

+ fying extra use= fields that are superfluous. infocmp

+ will flag any other termname use= fields that were not

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.

+ 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

+ <A HREF="ncurses.3x.html">curses(3x)</A> 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.

@@ -222,67 +248,71 @@

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

- <term.h>). 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

+ tables, needed in the C initializer for a TERMTYPE

+ structure (the terminal capability structure in the

+ <term.h>). 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 -e and -E

- options was not needed; but support for extended

+ Before ncurses 5.0, the split between the -e and -E

+ options was not needed; but support for extended

names required making the arrays of terminal capabil-

ities separate from the TERMTYPE structure.

- -e Dump the capabilities of the given terminal as a C

- initializer for a TERMTYPE structure (the terminal

- capability structure in the <term.h>). This option

+ -e Dump the capabilities of the given terminal as a C

+ initializer for a TERMTYPE structure (the terminal

+ capability structure in the <term.h>). This option

is useful for preparing versions of the curses

library hardwired for a given terminal type.

- -F compare terminfo files. This assumes that two fol-

- lowing arguments are filenames. The files are

- searched for pairwise matches between entries, with

+ -F 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-

+ 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 -r.

- -f Display complex terminfo strings which contain

+ -f Display complex terminfo strings which contain

if/then/else/endif expressions indented for readabil-

ity.

-G Display constant literals in decimal form rather than

their character equivalents.

- -g Display constant character literals in quoted form

+ -g Display constant character literals in quoted form

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

+ (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

+ 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

+ 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.

Action Meaning

-----------------------------------------

RIS full reset

SC save cursor

RC restore cursor

LL home-down

@@ -310,17 +340,16 @@

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

+ 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

@@ -398,18 +427,19 @@

</PRE>

<H2>FILES</H2><PRE>

- /usr/share/terminfo Compiled terminal description

- database.

+ /usr/share/terminfo Compiled terminal description data-

+ base.

</PRE>

<H2>EXTENSIONS</H2><PRE>

- The -E, -F, -G, -R, -T, -V, -a, -e, -f, -g, -i, -l, -p, -q

- and -t options are not supported in SVr4 curses.

+ 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.

@@ -420,10 +450,12 @@

</PRE>

- <A HREF="captoinfo.1m.html">captoinfo(1m)</A>, <A HREF="infotocap.1m.html">infotocap(1m)</A>, <A HREF="tic.1m.html">tic(1m)</A>, <A HREF="toe.1m.html">toe(1m)</A>,

+ <A HREF="captoinfo.1m.html">captoinfo(1m)</A>, <A HREF="infotocap.1m.html">infotocap(1m)</A>, <A HREF="tic.1m.html">tic(1m)</A>, <A HREF="toe.1m.html">toe(1m)</A>,

<A HREF="ncurses.3x.html">curses(3x)</A>, <A HREF="terminfo.5.html">terminfo(5)</A>.

- This describes ncurses version 5.9 (patch 20110404).

+ http://invisible-island.net/ncurses/tctest.html

+ This describes ncurses version 5.9 (patch 20131221).

</PRE>