X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fterminfo.5.html;h=becb62195bc697a2d8b2afc53b7fae7f11cbabd0;hp=87f9e8e46dd9bc4cdbf279e62b8bc6d2afd5cc3b;hb=62ca6190a9a8ddccb2c4d5ca7b2ef9f88432da65;hpb=c885a3fdd089f784f17dd2e9c03d8eb774072dc9
diff --git a/doc/html/man/terminfo.5.html b/doc/html/man/terminfo.5.html
index 87f9e8e4..becb6219 100644
--- a/doc/html/man/terminfo.5.html
+++ b/doc/html/man/terminfo.5.html
@@ -33,7 +33,7 @@
****************************************************************************
* @Id: terminfo.head,v 1.22 2016/10/15 17:02:31 tom Exp @
* Head of terminfo man page ends here
- * @Id: terminfo.tail,v 1.74 2016/11/05 21:15:43 Alain.Williams Exp @
+ * @Id: terminfo.tail,v 1.75 2016/12/24 22:54:11 tom Exp @
* Beginning of terminfo.tail file
* This file is part of ncurses.
* See "terminfo.head" for copyright.
@@ -75,7 +75,7 @@
nals by giving a set of capabilities which they have, by
specifying how to perform screen operations, and by speci-
fying padding requirements and initialization sequences.
- This describes ncurses version 6.0 (patch 20161203).
+ This describes ncurses version 6.0 (patch 20161224).
Entries in terminfo consist of a sequence of `,' separated
fields (embedded commas may be escaped with a backslash or
@@ -2067,41 +2067,57 @@
- Most color terminals are either "Tektronix-like" or "HP-
- like". Tektronix-like terminals have a predefined set of
- N colors (where N usually 8), and can set character-cell
- foreground and background characters independently, mixing
- them into N * N color-pairs. On HP-like terminals, the
- use must set each color pair up separately (foreground and
- background are not independently settable). Up to M
- color-pairs may be set up from 2*M different colors.
- ANSI-compatible terminals are Tektronix-like.
+ The curses library functions init_pair and init_color
+ manipulate the color pairs and color values discussed in
+ this section (see curs_color(3x) for details on these and
+ related functions).
+
+ Most color terminals are either "Tektronix-like" or "HP-
+ like":
+
+ o Tektronix-like terminals have a predefined set of N
+ colors (where N is usually 8), and can set character-
+ cell foreground and background characters indepen-
+ dently, mixing them into N * N color-pairs.
+
+ o On HP-like terminals, the user must set each color
+ pair up separately (foreground and background are not
+ independently settable). Up to M color-pairs may be
+ set up from 2*M different colors. ANSI-compatible
+ terminals are Tektronix-like.
Some basic color capabilities are independent of the color
method. The numeric capabilities colors and pairs specify
- the maximum numbers of colors and color-pairs that can be
- displayed simultaneously. The op (original pair) string
- resets foreground and background colors to their default
- values for the terminal. The oc string resets all colors
- or color-pairs to their default values for the terminal.
- Some terminals (including many PC terminal emulators)
- erase screen areas with the current background color
- rather than the power-up default background; these should
+ the maximum numbers of colors and color-pairs that can be
+ displayed simultaneously. The op (original pair) string
+ resets foreground and background colors to their default
+ values for the terminal. The oc string resets all colors
+ or color-pairs to their default values for the terminal.
+ Some terminals (including many PC terminal emulators)
+ erase screen areas with the current background color
+ rather than the power-up default background; these should
have the boolean capability bce.
- To change the current foreground or background color on a
- Tektronix-type terminal, use setaf (set ANSI foreground)
- and setab (set ANSI background) or setf (set foreground)
- and setb (set background). These take one parameter, the
- color number. The SVr4 documentation describes only
- setaf/setab; the XPG4 draft says that "If the terminal
- supports ANSI escape sequences to set background and fore-
- ground, they should be coded as setaf and setab, respec-
- tively. If the terminal supports other escape sequences
- to set background and foreground, they should be coded as
- setf and setb, respectively. The vidputs function and the
- refresh functions use setaf and setab if they are
- defined."
+ While the curses library works with color pairs (reflect-
+ ing the inability of some devices to set foreground and
+ background colors independently), there are separate capa-
+ bilities for setting these features:
+
+ o To change the current foreground or background color
+ on a Tektronix-type terminal, use setaf (set ANSI
+ foreground) and setab (set ANSI background) or setf
+ (set foreground) and setb (set background). These
+ take one parameter, the color number. The SVr4 docu-
+ mentation describes only setaf/setab; the XPG4 draft
+ says that "If the terminal supports ANSI escape
+ sequences to set background and foreground, they
+ should be coded as setaf and setab, respectively.
+
+ o If the terminal supports other escape sequences to set
+ background and foreground, they should be coded as
+ setf and setb, respectively. The vidputs and the
+ refresh functions use the setaf and setab capabilities
+ if they are defined.
The setaf/setab and setf/setb capabilities take a single
numeric argument each. Argument values 0-7 of setaf/setab
@@ -2141,21 +2157,25 @@
On an HP-like terminal, use scp with a color-pair number
parameter to set which color pair is current.
- On a Tektronix-like terminal, the capability ccc may be
- present to indicate that colors can be modified. If so,
- the initc capability will take a color number (0 to colors
- - 1)and three more parameters which describe the color.
- These three parameters default to being interpreted as RGB
- (Red, Green, Blue) values. If the boolean capability hls
- is present, they are instead as HLS (Hue, Lightness, Satu-
- ration) indices. The ranges are terminal-dependent.
-
- On an HP-like terminal, initp may give a capability for
- changing a color-pair value. It will take seven parame-
- ters; a color-pair number (0 to max_pairs - 1), and two
- triples describing first background and then foreground
- colors. These parameters must be (Red, Green, Blue) or
- (Hue, Lightness, Saturation) depending on hls.
+ Some terminals allow the color values to be modified:
+
+ o On a Tektronix-like terminal, the capability ccc may
+ be present to indicate that colors can be modified.
+ If so, the initc capability will take a color number
+ (0 to colors - 1)and three more parameters which
+ describe the color. These three parameters default to
+ being interpreted as RGB (Red, Green, Blue) values.
+ If the boolean capability hls is present, they are
+ instead as HLS (Hue, Lightness, Saturation) indices.
+ The ranges are terminal-dependent.
+
+ o On an HP-like terminal, initp may give a capability
+ for changing a color-pair value. It will take seven
+ parameters; a color-pair number (0 to max_pairs - 1),
+ and two triples describing first background and then
+ foreground colors. These parameters must be (Red,
+ Green, Blue) or (Hue, Lightness, Saturation) depending
+ on hls.
On some color terminals, colors collide with highlights.
You can register these collisions with the ncv capability.
@@ -2493,8 +2513,8 @@
- tic(1m), infocmp(1m), curses(3x), printf(3), term(5).
- term_variables(3x).
+ tic(1m), infocmp(1m), curses(3x), curs_color(3x),
+ printf(3), term(5). term_variables(3x).