X-Git-Url: http://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_getcchar.3x.html;h=73597971cc9650d294451fa788635da29a8324e2;hp=224cbc6613357e0ba7f248591ff71ec91caf97d6;hb=3eda6f30a84d53844d2ebceadb457e2e7e9cfbf3;hpb=2e68dc325852af56f2ec6c315b323a4f9c3d62c9
diff --git a/doc/html/man/curs_getcchar.3x.html b/doc/html/man/curs_getcchar.3x.html
index 224cbc66..73597971 100644
--- a/doc/html/man/curs_getcchar.3x.html
+++ b/doc/html/man/curs_getcchar.3x.html
@@ -1,6 +1,6 @@
@@ -117,10 +117,26 @@
allowed.
-
- The opts argument is reserved for future use. Currently,
- an application must provide a null pointer as opts.
+
+ X/Open Curses documents the opts argument as reserved for
+ future use, saying that it must be null. This implementa-
+ tion uses that parameter in ABI 6 for the functions which
+ have a color-pair parameter to support extended color
+ pairs:
+
+ o For functions which modify the color, e.g., setc-
+ char, if opts is set it is treated as a pointer to
+ int, and used to set the color pair instead of the
+ short pair parameter.
+
+ o For functions which retrieve the color, e.g., getc-
+ char, if opts is set it is treated as a pointer to
+ int, and used to retrieve the color pair as an int
+ value, in addition retrieving it via the standard
+ pointer to short parameter.
+
+
The wcval argument may be a value generated by a call to
setcchar or by a function that has a cchar_t output argu-
ment. If wcval is constructed by any other means, the
@@ -157,6 +173,7 @@
setcchar
+EXTENSIONS
NOTES
RETURN VALUE
SEE ALSO