[PATCH 06/23] man/curs_add{,_w}ch.3x: Define term "blank character".

[G. Branden Robinson]

---
 man/curs_add_wch.3x | 13 ++++++++++++-
 man/curs_addch.3x   | 10 ++++++++++
 2 files changed, 22 insertions(+), 1 deletion(-)

diff --git a/man/curs_add_wch.3x b/man/curs_add_wch.3x
index 8e293b928..0a69ebbef 100644
--- a/man/curs_add_wch.3x
+++ b/man/curs_add_wch.3x
@@ -96,7 +96,8 @@ .SS wadd_wch
 If
 .I wch
 contains only non-spacing characters,
-.\" XXX: see wadd_wch_literal (the beginning of the array may be nonspacing)
+.\" XXX: see wadd_wch_literal (the beginning of the array may be
+.\" nonspacing)
 they are combined with the active complex character.
 .I curses
 ignores its attributes and color pair identifier,
@@ -159,6 +160,15 @@ .SS wadd_wch
 .I \%cchar_t
 can be copied from place to place using \fB\%win_wch\fP(3X) and
 .BR \%wadd_wch "."
+See \fB\%curs_attr\fP(3X) for values of predefined constants that can be
+usefully \*(``or\*(''ed with characters.
+A complex character whose character component is a wide space,
+and whose only attribute is
+.BR \%WA_NORMAL ,
+is a
+.IR "blank character" ","
+and therefore combines with the background character;
+see \fB\%curs_bkgrnd\fP(3X).
 .SS wecho_wchar
 .B \%echo_wchar
 and
@@ -555,6 +565,7 @@ .SH SEE ALSO
 \fB\%curs_addwstr\fP(3X),
 \fB\%curs_add_wchstr\fP(3X),
 \fB\%curs_attr\fP(3X),
+\fB\%curs_bkgrnd\fP(3X),
 \fB\%curs_clear\fP(3X),
 \fB\%curs_getcchar\fP(3X),
 \fB\%curs_outopts\fP(3X),
diff --git a/man/curs_addch.3x b/man/curs_addch.3x
index c70b8a869..17ef31a98 100644
--- a/man/curs_addch.3x
+++ b/man/curs_addch.3x
@@ -140,6 +140,15 @@ .SS waddch
 .BR \%waddch .)
 See \fB\%curs_attr\fP(3X) for values of predefined constants that can be
 usefully \*(``or\*(''ed with characters.
+A
+.I ch
+whose character component is a space,
+and whose only attribute is
+.BR \%A_NORMAL ,
+is a
+.IR "blank character" ","
+and therefore combines with the background character;
+see \fB\%curs_bkgd\fP(3X).
 .SS wechochar
 .B \%echochar
 and
@@ -497,6 +506,7 @@ .SH SEE ALSO
 \fB\%curs_addchstr\fP(3X),
 \fB\%curs_addstr\fP(3X),
 \fB\%curs_attr\fP(3X),
+\fB\%curs_bkgd\fP(3X),
 \fB\%curs_clear\fP(3X),
 \fB\%curs_inch\fP(3X),
 \fB\%curs_outopts\fP(3X),
-- 
2.30.2

signature.asc
Description: PGP signature