X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=man%2Fcurs_bkgrnd.3x;h=f9b4f41964f88c96148ad68f672343380b10d63e;hp=2bbb4fce4581b8ed8e8f2507de1da75000bdbeca;hb=2e68dc325852af56f2ec6c315b323a4f9c3d62c9;hpb=5eb177874dea59107a1a2ea44f5d8f5bb99550b2 diff --git a/man/curs_bkgrnd.3x b/man/curs_bkgrnd.3x index 2bbb4fce..f9b4f419 100644 --- a/man/curs_bkgrnd.3x +++ b/man/curs_bkgrnd.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright (c) 2002-2012,2015 Free Software Foundation, Inc. * +.\" Copyright (c) 2002-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 +26,7 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_bkgrnd.3x,v 1.6 2015/07/21 00:18:42 tom Exp $ +.\" $Id: curs_bkgrnd.3x,v 1.7 2017/03/25 21:49:00 tom Exp $ .de bP .IP \(bu 4 .. @@ -87,6 +87,8 @@ appears, it is changed to the new background character. .PP The \fBgetbkgrnd\fR function returns the given window's current background character/attribute pair via the \fBwch\fR pointer. +If the given window pointer is null, +the character is not updated (but no error returned). .SH NOTES Note that \fBbkgrnd\fR, @@ -98,8 +100,11 @@ may be macros. The \fBbkgrndset\fR and \fBwbkgrndset\fR routines do not return a value. .PP Upon successful completion, the other functions return \fBOK\fR. -Otherwise, they return \fBERR\fR. +Otherwise, they return \fBERR\fR: +.bP A null window pointer is treated as an error. +.bP +A null character pointer is treated as an error. .SH SEE ALSO \fBcurses\fR(3X), \fBcurs_bkgd\fR(3X)