X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=man%2Fcurs_bkgd.3x;h=356eff470819f81df2246c943d704377a90cc081;hp=d93bbd4a995e1b5e197033f2c6814db266e68d4c;hb=9f479192e3ca3413d235c66bf058f8cc63764898;hpb=321b81e6b3fa425daddac02420d862100dc3aac8 diff --git a/man/curs_bkgd.3x b/man/curs_bkgd.3x index d93bbd4a..356eff47 100644 --- a/man/curs_bkgd.3x +++ b/man/curs_bkgd.3x @@ -1,5 +1,6 @@ .\"*************************************************************************** -.\" Copyright (c) 1998-2017,2018 Free Software Foundation, Inc. * +.\" Copyright 2018-2020,2021 Thomas E. Dickey * +.\" Copyright 1998-2015,2017 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 * @@ -26,7 +27,7 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_bkgd.3x,v 1.28 2018/12/09 00:45:05 tom Exp $ +.\" $Id: curs_bkgd.3x,v 1.32 2021/06/17 21:30:22 tom Exp $ .de bP .ie n .IP \(bu 4 .el .IP \(bu 2 @@ -42,11 +43,11 @@ \fBvoid bkgdset(chtype \fP\fIch\fP\fB);\fR .br \fBvoid wbkgdset(WINDOW *\fP\fIwin, chtype \fP\fIch\fP\fB);\fR -.br +.sp \fBint bkgd(chtype \fP\fIch\fP\fB);\fR .br \fBint wbkgd(WINDOW *\fP\fIwin\fP\fB, chtype \fP\fIch\fP\fB);\fR -.br +.sp \fBchtype getbkgd(WINDOW *\fP\fIwin\fP\fB);\fR .br .SH DESCRIPTION @@ -102,7 +103,7 @@ cell with those from the new background character. If the cell uses color, and that matches the color in the current background, the library removes attributes -which may have come from the current background +which may have come from the current background and adds attributes from the new background. It finishes by setting the cell to use the color from the new background. @@ -112,6 +113,12 @@ and that does not match the color in the current background, the library updates only the non-color attributes, first removing those which may have come from the current background, and then adding attributes from the new background. +.PP +If the background's character value is zero, a space is assumed. +.PP +If the terminal does not support color, +or if color has not been started with \fBstart_color\fP, +the new background character's color attribute will be ignored. .SS getbkgd .PP The \fBgetbkgd\fR function returns the given window's current background