.\"***************************************************************************
-.\" Copyright 2018-2020,2021 Thomas E. Dickey *
+.\" Copyright 2018-2021,2022 Thomas E. Dickey *
.\" Copyright 2002-2015,2017 Free Software Foundation, Inc. *
.\" *
.\" Permission is hereby granted, free of charge, to any person obtaining a *
.\" authorization. *
.\"***************************************************************************
.\"
-.\" $Id: curs_bkgrnd.3x,v 1.14 2021/12/25 21:41:58 tom Exp $
+.\" $Id: curs_bkgrnd.3x,v 1.16 2022/06/25 21:57:59 tom Exp $
.de bP
.ie n .IP \(bu 4
.el .IP \(bu 2
.PP
.B #include <curses.h>
.sp
-\fBint bkgrnd(\fP\fB const cchar_t *\fP\fIwch\fP\fB);\fP
+\fBint bkgrnd(\fB const cchar_t *\fIwch\fB);\fR
.br
-\fBint wbkgrnd(\fP\fB WINDOW *\fP\fIwin\fP\fB, const cchar_t *\fP\fIwch\fP\fB);\fP
+\fBint wbkgrnd(\fB WINDOW *\fIwin\fB, const cchar_t *\fIwch\fB);\fR
.sp
-\fBvoid bkgrndset(const cchar_t *\fP\fIwch\fP \fB);\fP
+\fBvoid bkgrndset(const cchar_t *\fIwch\fR \fB);\fR
.br
-\fBvoid wbkgrndset(WINDOW *\fP\fIwin\fP\fB, const cchar_t *\fP\fIwch\fP\fB);\fP
+\fBvoid wbkgrndset(WINDOW *\fIwin\fB, const cchar_t *\fIwch\fB);\fR
.sp
-\fBint getbkgrnd(cchar_t *\fP\fIwch\fP\fB);\fP
+\fBint getbkgrnd(cchar_t *\fIwch\fB);\fR
.br
-\fBint wgetbkgrnd(WINDOW *\fP\fIwin\fP\fB, cchar_t *\fP\fIwch\fP\fB);\fP
+\fBint wgetbkgrnd(WINDOW *\fIwin\fB, cchar_t *\fIwch\fB);\fR
.br
.SH DESCRIPTION
.SS bkgrndset
background of the named window.
The window background is a \fBcchar_t\fP consisting of
any combination of attributes (i.e., rendition) and a complex character.
+.bP
The attribute part of the background is combined (OR'ed) with all non-blank
characters that are written into the window with \fBwaddch\fP.
+.bP
Both
the character and attribute parts of the background are combined with
the blank characters.
+.PP
The background becomes a property of the
character and moves with the character through any scrolling and
insert/delete line/character operations.