X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_outopts.3x.html;h=1ff83a943728bb4c114f9117d692140cdfb4039a;hp=ae728815a313549e2bb1ac6a3707f284ad4b825f;hb=55ccd2b959766810cf7db8d1c4462f338ce0afc8;hpb=a8987e73ec254703634802b4f7ee30d3a485524d diff --git a/doc/html/man/curs_outopts.3x.html b/doc/html/man/curs_outopts.3x.html index ae728815..1ff83a94 100644 --- a/doc/html/man/curs_outopts.3x.html +++ b/doc/html/man/curs_outopts.3x.html @@ -1,7 +1,7 @@
@@ -40,14 +40,14 @@-curs_outopts(3x) curs_outopts(3x) +curs_outopts(3x) curs_outopts(3x)
- clearok, idlok, idcok, immedok, leaveok, setscrreg, + clearok, idlok, idcok, immedok, leaveok, setscrreg, wsetscrreg, scrollok, nl, nonl - curses output options @@ -71,8 +71,8 @@DESCRIPTION
These routines set options that change the style of output within curses. All options are initially FALSE, unless - otherwise stated. It is not necessary to turn these - options off before calling endwin. + otherwise stated. It is not necessary to turn these op- + tions off before calling endwin. If clearok is called with TRUE as argument, the next call to wrefresh with this window will clear the screen com- @@ -106,30 +106,29 @@ the window image, such as the ones caused by waddch, wclr- tobot, wscrl, etc., automatically cause a call to wre- fresh. However, it may degrade performance considerably, - due to repeated calls to wrefresh. It is disabled by - default. + due to repeated calls to wrefresh. It is disabled by de- + fault. Normally, the hardware cursor is left at the location of - the window cursor being refreshed. The leaveok option - allows the cursor to be left wherever the update happens - to leave it. It is useful for applications where the cur- - sor is not used, since it reduces the need for cursor - motions. + the window cursor being refreshed. The leaveok option al- + lows the cursor to be left wherever the update happens to + leave it. It is useful for applications where the cursor + is not used, since it reduces the need for cursor motions. The setscrreg and wsetscrreg routines allow the applica- tion programmer to set a software scrolling region in a window. top and bot are the line numbers of the top and bottom margin of the scrolling region. (Line 0 is the top - line of the window.) If this option and scrollok are - enabled, an attempt to move off the bottom margin line - causes all lines in the scrolling region to scroll one - line in the direction of the first line. Only the text of - the window is scrolled. (Note that this has nothing to do + line of the window.) If this option and scrollok are en- + abled, an attempt to move off the bottom margin line caus- + es all lines in the scrolling region to scroll one line in + the direction of the first line. Only the text of the + window is scrolled. (Note that this has nothing to do with the use of a physical scrolling region capability in the terminal, like that in the VT100. If idlok is enabled - and the terminal has either a scrolling region or - insert/delete line capability, they will probably be used - by the output routines.) + and the terminal has either a scrolling region or in- + sert/delete line capability, they will probably be used by + the output routines.) The scrollok option controls what happens when the cursor of a window is moved off the edge of the window or @@ -159,6 +158,23 @@ cess and ERR upon failure. All other routines that return an integer always return OK. + X/Open does not define any error conditions. + + In this implementation, those functions that have a window + pointer will return an error if the window pointer is + null. + + wclrtoeol + returns an error if the cursor position is + about to wrap. + + wsetscrreg + returns an error if the scrolling region lim- + its extend outside the window. + + X/Open does not define any error conditions. This imple- + mentation returns an error if the window pointer is null. +PORTABILITY
@@ -171,7 +187,7 @@ translations; AT&T curses (at least as late as SVr1) did not. We choose to do so, on the theory that a programmer requesting raw input wants a clean (ideally 8-bit clean) - connection that the operating system does not mess with. + connection that the operating system will not alter. Some historic curses implementations had, as an undocu- mented feature, the ability to do the equivalent of @@ -206,7 +222,7 @@ - curs_outopts(3x) + curs_outopts(3x)