X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=man%2Fcurs_bkgd.3x;h=c177a4114c57d7b66ecb113bd5284b9765d618f8;hp=f5c620db55cf065cf052257305a0e48b0626427a;hb=4f10f7dff42e5348b814bdce71d3e4d925bd6ed6;hpb=46722468f47c2b77b3987729b4bcf2321cccfd01 diff --git a/man/curs_bkgd.3x b/man/curs_bkgd.3x index f5c620db..c177a411 100644 --- a/man/curs_bkgd.3x +++ b/man/curs_bkgd.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright (c) 1998-2000,2002 Free Software Foundation, Inc. * +.\" Copyright (c) 1998-2003,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 * @@ -26,16 +26,15 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_bkgd.3x,v 1.18 2002/09/21 19:46:26 tom Exp $ +.\" $Id: curs_bkgd.3x,v 1.20 2010/01/30 21:29:04 Tim.van.der.Molen Exp $ .TH curs_bkgd 3X "" .SH NAME \fBbkgdset\fR, \fBwbkgdset\fR, \fBbkgd\fR, \fBwbkgd\fR, \fBgetbkgd\fR - \fBcurses\fR window background manipulation routines - .SH SYNOPSIS \fB#include \fR - +.PP \fBvoid bkgdset(chtype ch);\fR .br \fBvoid wbkgdset(WINDOW *win, chtype ch);\fR @@ -57,23 +56,23 @@ the character and attribute parts of the background are combined with the blank characters. The background becomes a property of the character and moves with the character through any scrolling and insert/delete line/character operations. - +.PP To the extent possible on a particular terminal, the attribute part of the background is displayed as the graphic rendition of the character put on the screen. - +.PP The \fBbkgd\fR and \fBwbkgd\fR functions set the background property of the current or specified window and then apply this setting to every character position in that window: - +.PP .RS The rendition of every character on the screen is changed to the new background rendition. - +.PP Wherever the former background character appears, it is changed to the new background character. .RE - +.PP The \fBgetbkgd\fR function returns the given window's current background character/attribute pair. .SH RETURN VALUE @@ -84,7 +83,7 @@ but this appears to be an error. Note that \fBbkgdset\fR and \fBbkgd\fR may be macros. .SH PORTABILITY These functions are described in the XSI Curses standard, Issue 4. -It specifies that \fBbkgd\fR and \fBwbkgd\fR return \fBERR\fR on failure. +It specifies that \fBbkgd\fR and \fBwbkgd\fR return \fBERR\fR on failure, but gives no failure conditions. .SH SEE ALSO \fBcurses\fR(3X),