X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=man%2Fdefault_colors.3x;h=0b85598eea459873a301b298d4098d62a8eacd5e;hp=32518ba9d9cf1124a8a20f170400fd53a5754f65;hb=5e36f11feab6f790e0cc6f2c882a67b7b65e3b6b;hpb=f70db18a0c3c6a828d8a5999be37239f01c9d98a diff --git a/man/default_colors.3x b/man/default_colors.3x index 32518ba9..0b85598e 100644 --- a/man/default_colors.3x +++ b/man/default_colors.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright (c) 1998-2005,2006 Free Software Foundation, Inc. * +.\" Copyright (c) 1998-2010,2011 Free Software Foundation, Inc. * .\" * .\" 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 @@ .\" .\" Author: Thomas E. Dickey 1997,1999,2000,2005 .\" -.\" $Id: default_colors.3x,v 1.20 2006/12/24 15:02:53 tom Exp $ +.\" $Id: default_colors.3x,v 1.23 2011/01/03 21:52:27 Tim.van.der.Molen Exp $ .TH default_colors 3X "" .SH NAME \fBuse_default_colors\fR, @@ -64,14 +64,14 @@ visual effects. The first function, .I use_default_colors() tells the curses library to assign terminal default -foreground/background colors to color number -1. So init_pair(x,COLOR_RED,-1) -will initialize pair x as red on default background and init_pair(x,-1,COLOR_BLUE) will +foreground/background colors to color number \-1. So init_pair(x,COLOR_RED,\-1) +will initialize pair x as red on default background and init_pair(x,\-1,COLOR_BLUE) will initialize pair x as default foreground on blue. .PP The other, .I assume_default_colors() is a refinement which tells which colors to paint for color pair 0. -This function recognizes a special color number -1, +This function recognizes a special color number \-1, which denotes the default terminal color. .PP The following are equivalent: @@ -79,12 +79,12 @@ The following are equivalent: .br .I use_default_colors(); .br -.I assume_default_colors(-1,-1); +.I assume_default_colors(\-1,\-1); .RE .PP These are ncurses extensions. For other curses implementations, color -number -1 does not mean anything, just as for ncurses before a +number \-1 does not mean anything, just as for ncurses before a successful call of \fIuse_default_colors()\fP or \fIassume_default_colors()\fP. .PP Other curses implementations do not allow an application to modify color pair 0. @@ -101,7 +101,7 @@ for color pair 0. These functions return the integer \fBERR\fP upon failure and \fBOK\fP on success. They will fail if either the terminal does not support the \fIorig_pair\fP or \fIorig_colors\fP capability. -If the \fIinitialize_pair\fP capability is found, this causes an +If the \fIinitialize_pair\fP capability is not found, this causes an error as well. .SH NOTES Associated with this extension, the \fBinit_pair\fR function accepts @@ -136,9 +136,3 @@ any code depending on them be conditioned using NCURSES_VERSION. .SH AUTHOR Thomas Dickey (from an analysis of the requirements for color xterm for XFree86 3.1.2C, February 1996). -.\"# -.\"# The following sets edit modes for GNU EMACS -.\"# Local Variables: -.\"# mode:nroff -.\"# fill-column:79 -.\"# End: