[src/trunk]: src/lib/libcurses Rename can_change_colors() to can_change_color().

[jdc <jdc%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/6d64a39cc424
branches:  trunk
changeset: 542393:6d64a39cc424
user:      jdc <jdc%NetBSD.org@localhost>
date:      Mon Jan 27 21:03:04 2003 +0000

description:
Rename can_change_colors() to can_change_color().
Add no_color_video().

diffstat:

 lib/libcurses/PSD.doc/fns.doc |   6 +++++-
 lib/libcurses/curses_color.3  |  21 ++++++++++++++++-----
 2 files changed, 21 insertions(+), 6 deletions(-)

diffs (97 lines):

diff -r 54ac1726cd1d -r 6d64a39cc424 lib/libcurses/PSD.doc/fns.doc
--- a/lib/libcurses/PSD.doc/fns.doc     Mon Jan 27 21:01:00 2003 +0000
+++ b/lib/libcurses/PSD.doc/fns.doc     Mon Jan 27 21:03:04 2003 +0000
@@ -176,7 +176,7 @@
 and the window encompasses the lower right-hand corner of the terminal,
 the corners are left blank to avoid a scroll.
 .Ds
-.Fn can_change_colors ""
+.Fn can_change_color ""
 .De
 Check if terminal can change colors.
 .Ds
@@ -1062,6 +1062,10 @@
 can do more optimization,
 so it is recommended, but not required, to turn it off.
 .Ds
+.Fn no_color_video ""
+.De
+Return attributes that cannot be combined with color.
+.Ds
 .Fn nocbreak "" \(dg
 .De
 Unset the terminal from cbreak mode.
diff -r 54ac1726cd1d -r 6d64a39cc424 lib/libcurses/curses_color.3
--- a/lib/libcurses/curses_color.3      Mon Jan 27 21:01:00 2003 +0000
+++ b/lib/libcurses/curses_color.3      Mon Jan 27 21:03:04 2003 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: curses_color.3,v 1.2 2002/10/21 14:17:54 wiz Exp $
+.\"    $NetBSD: curses_color.3,v 1.3 2003/01/27 21:03:05 jdc Exp $
 .\" Copyright (c) 2002 The NetBSD Foundation, Inc.
 .\" All rights reserved.
 .\"
@@ -28,20 +28,21 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd October 13, 2002
+.Dd January 27, 2003
 .Dt CURSES_COLOR 3
 .Os
 .Sh NAME
 .Nm curses_color ,
 .Nm has_colors ,
-.Nm can_change_colors ,
+.Nm can_change_color ,
 .Nm start_color ,
 .Nm init_pair ,
 .Nm pair_content ,
 .Nm COLOR_PAIR ,
 .Nm PAIR_NUMBER ,
 .Nm init_color ,
-.Nm color_content
+.Nm color_content ,
+.Nm no_color_video
 .Nd curses color manipulation routines
 .Sh LIBRARY
 .Lb libcurses
@@ -65,6 +66,8 @@
 .Fn init_color "short color" "short red" "short green" "short blue"
 .Ft int
 .Fn color_content "short color" "short *red" "short *green" "short *blue"
+.Ft attr_t
+.Fn no_color_video void
 .Ft extern int
 .Dv COLOR_PAIRS
 .Ft extern int
@@ -82,7 +85,7 @@
 otherwise.
 .Pp
 The function
-.Fn can_change_colors
+.Fn can_change_color
 indicates whether a terminal is capable of redefining colors.
 It returns
 .Dv TRUE
@@ -179,6 +182,10 @@
 and
 .Fa blue ,
 respectively.
+.Pp
+The function
+.Fn no_color_video
+returns those attributes that a terminal is unable to combine with color.
 .Sh RETURN VALUES
 The functions
 .Fn start_color ,
@@ -197,6 +204,10 @@
 .Nx
 Curses library complies with the X/Open Curses specification, part of the
 Single Unix Specification.
+.Pp
+The function
+.Fn no_color_video
+is an extension to the X/Open Curses specification.
 .Sh HISTORY
 These functions first appeared in
 .Nx 1.5 .