X-Git-Url: https://ncurses.scripts.mit.edu/?a=blobdiff_plain;f=man%2Fcurs_outopts.3x;h=85c350b4800deee90535c288d99dd0e9a47adaef;hb=122d3739b3c11c83decc625d53f26fff6e825710;hp=3f7eb90ecd9cb5ee1a82d4dc7acdc15cc3027bfb;hpb=31c4bcf3307145fc5368b4aaf15e41bdd66a984b;p=ncurses.git diff --git a/man/curs_outopts.3x b/man/curs_outopts.3x index 3f7eb90e..85c350b4 100644 --- a/man/curs_outopts.3x +++ b/man/curs_outopts.3x @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_outopts.3x,v 1.44 2023/09/16 23:37:03 tom Exp $ -.TH curs_outopts 3X 2023-09-16 "ncurses 6.4" "Library calls" +.\" $Id: curs_outopts.3x,v 1.50 2023/11/11 11:46:54 tom Exp $ +.TH curs_outopts 3X 2023-11-11 "ncurses 6.4" "Library calls" .de bP .ie n .IP \(bu 4 .el .IP \(bu 2 @@ -44,23 +44,19 @@ \fB\%scrollok\fP \- set \fIcurses\fR output options .SH SYNOPSIS -\fB#include \fP -.sp -\fBint clearok(WINDOW *\fIwin\fB, bool \fIbf\fB);\fR -.br -\fBint idlok(WINDOW *\fIwin\fB, bool \fIbf\fB);\fR -.br -\fBvoid idcok(WINDOW *\fIwin\fB, bool \fIbf\fB);\fR -.br -\fBvoid immedok(WINDOW *\fIwin\fB, bool \fIbf\fB);\fR -.br -\fBint leaveok(WINDOW *\fIwin\fB, bool \fIbf\fB);\fR -.br -\fBint scrollok(WINDOW *\fIwin\fB, bool \fIbf\fB);\fR -.sp -\fBint setscrreg(int \fItop\fB, int \fIbot\fB);\fR -.br -\fBint wsetscrreg(WINDOW *\fIwin\fB, int \fItop\fB, int \fIbot\fB);\fR +.nf +\fB#include +.PP +\fBint clearok(WINDOW *\fIwin\fP, bool \fIbf\fP); +\fBint idlok(WINDOW *\fIwin\fP, bool \fIbf\fP); +\fBvoid idcok(WINDOW *\fIwin\fP, bool \fIbf\fP); +\fBvoid immedok(WINDOW *\fIwin\fP, bool \fIbf\fP); +\fBint leaveok(WINDOW *\fIwin\fP, bool \fIbf\fP); +\fBint scrollok(WINDOW *\fIwin\fP, bool \fIbf\fP); +.PP +\fBint setscrreg(int \fItop\fP, int \fIbot\fP); +\fBint wsetscrreg(WINDOW *\fIwin\fP, int \fItop\fP, int \fIbot\fP); +.fi .SH DESCRIPTION These routines set options that change the style of output within \fBcurses\fP. @@ -97,12 +93,15 @@ Use of character insert/delete is enabled by default. Calling \fBidcok\fP with \fBTRUE\fP as second argument re-enables use of character insertion and deletion. .SS immedok -If \fBimmedok\fP is called with \fBTRUE as argument\fP, any change -in the window image, such as the ones caused by \fBwaddch, wclrtobot, wscrl\fP, -etc., automatically cause a call to \fBwrefresh\fP. -However, it may -degrade performance considerably, due to repeated calls to \fBwrefresh\fP. -It is disabled by default. +If \fBimmedok\fP is called with \fBTRUE\fP as second argument, +any change in the window image, +such as the ones caused by \fBwaddch, wclrtobot, wscrl\fP, +etc., automatically causes a call to \fBwrefresh\fP. +However, it may degrade performance considerably, +due to repeated calls to \fBwrefresh\fP. +Calling \fBimmedok\fP with \fBFALSE\fP as second argument +restores the default behavior, +i.e., deferring screen updates until a refresh is needed. .SS leaveok Normally, the hardware cursor is left at the location of the window cursor being refreshed. @@ -200,11 +199,10 @@ Note that The \fBimmedok\fP routine is useful for windows that are used as terminal emulators. .SH SEE ALSO -.na -\fBcurses\fP(3X), -\fBcurs_addch\fP(3X), -\fBcurs_clear\fP(3X), -\fBcurs_initscr\fP(3X), -\fBcurs_scroll\fP(3X), -\fBcurs_refresh\fP(3X), -\fBcurs_variables\fP(3X). +\fB\%curses\fP(3X), +\fB\%curs_addch\fP(3X), +\fB\%curs_clear\fP(3X), +\fB\%curs_initscr\fP(3X), +\fB\%curs_refresh\fP(3X), +\fB\%curs_scroll\fP(3X), +\fB\%curs_variables\fP(3X)