X-Git-Url: http://ncurses.scripts.mit.edu/?a=blobdiff_plain;ds=sidebyside;f=man%2Fdefault_colors.3x;h=ca0db728bc6dc8b9789276b97080d9b6114f6278;hb=71c0306f0824ef2b10c4c5813fb003db48f3012e;hp=e00b4981c2d52d49a16361c25386ebb446e80ccd;hpb=55ccd2b959766810cf7db8d1c4462f338ce0afc8;p=ncurses.git diff --git a/man/default_colors.3x b/man/default_colors.3x index e00b4981..ca0db728 100644 --- a/man/default_colors.3x +++ b/man/default_colors.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright (c) 1998-2003,2005 Free Software Foundation, Inc. * +.\" Copyright (c) 1998-2006,2010 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,14 +28,14 @@ .\" .\" Author: Thomas E. Dickey 1997,1999,2000,2005 .\" -.\" $Id: default_colors.3x,v 1.18 2005/02/19 20:25:44 tom Exp $ +.\" $Id: default_colors.3x,v 1.21 2010/07/31 16:10:55 tom Exp $ .TH default_colors 3X "" .SH NAME \fBuse_default_colors\fR, \fBassume_default_colors\fR \- use terminal's default colors .SH SYNOPSIS \fB#include \fP - +.sp \fBint use_default_colors(void);\fP .br \fBint assume_default_colors(int fg, int bg);\fP @@ -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. @@ -104,9 +104,8 @@ the \fIorig_pair\fP or \fIorig_colors\fP capability. If the \fIinitialize_pair\fP capability is found, this causes an error as well. .SH NOTES -Associated with this extension, the \fBinit_pair\fR(3X) function accepts -negative arguments to specify default foreground or background -colors. +Associated with this extension, the \fBinit_pair\fR function accepts +negative arguments to specify default foreground or background colors. .PP The \fIuse_default_colors()\fP function was added to support \fIded\fP. This is a full-screen application which uses curses to manage only part