X-Git-Url: http://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Finfocmp.1m.html;h=bfcde8acc72f688499056f2c6fdb69a580b9a36c;hp=98354c28da1215813adeea77d69614cdc2357dba;hb=761e4f0825b330e970558e82a4bd638383914429;hpb=77afe78361875f531dc2bf8d73f2e781c8e76176
diff --git a/doc/html/man/infocmp.1m.html b/doc/html/man/infocmp.1m.html
index 98354c28..bfcde8ac 100644
--- a/doc/html/man/infocmp.1m.html
+++ b/doc/html/man/infocmp.1m.html
@@ -1,8 +1,8 @@
-
+
@@ -53,7 +53,7 @@
SYNOPSIS
- infocmp [-1CEFGILTUVcdegilnpqrtux]
+ infocmp [-1CDEFGIKLTUVcdegilnpqrtux]
[-v n] [-s d| i| l| c] [-R subset]
[-w width] [-A directory] [-B directory]
[termname...]
@@ -89,15 +89,15 @@
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]
The -I, -L, and -C options will produce a source listing
@@ -107,6 +107,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 +119,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 +140,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-
@@ -200,28 +215,42 @@
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
+ 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
- -1 causes the fields to be printed out one to a line.
- Otherwise, the fields will be printed several to a
+ -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 +312,7 @@
Action Meaning
-----------------------------------------
RIS full reset
+
SC save cursor
RC restore cursor
LL home-down
@@ -310,7 +340,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
@@ -404,12 +433,13 @@
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.
+ 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 @@
SEE ALSO
- captoinfo(1m), infotocap(1m), tic(1m), toe(1m),
+ 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 5.9 (patch 20130518).