X-Git-Url: http://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_touch.3x.html;h=d63e4de8d24ed2ee2ba3104fbba51ed252acd3e5;hp=6fec2909cdafe1c7d01c8d1105b221be82a58dee;hb=ed646e3f683083e787c6ba773364401dc9fa9d40;hpb=c6cfd97b8beaf0f6deafbf8aac7281cf6aa7f012
diff --git a/doc/html/man/curs_touch.3x.html b/doc/html/man/curs_touch.3x.html
index 6fec2909..d63e4de8 100644
--- a/doc/html/man/curs_touch.3x.html
+++ b/doc/html/man/curs_touch.3x.html
@@ -1,6 +1,6 @@
@@ -38,22 +38,19 @@
-curs_touch 3x
-
+
-curs_touch(3x) curs_touch(3x)
+curs_touch(3x) curs_touch(3x)
-
-
+
touchwin, touchline, untouchwin, wtouchln, is_linetouched,
is_wintouched - curses refresh control routines
-
-
+
#include <curses.h>
int touchwin(WINDOW *win);
int touchline(WINDOW *win, int start, int count);
@@ -63,78 +60,64 @@
bool is_wintouched(WINDOW *win);
-
-
- The touchwin and touchline routines throw away all opti-
- mization information about which parts of the window have
- been touched, by pretending that the entire window has
- been drawn on. This is sometimes necessary when using
- overlapping windows, since a change to one window affects
- the other window, but the records of which lines have been
- changed in the other window do not reflect the change.
- The routine touchline only pretends that count lines have
- been changed, beginning with line start.
-
- The untouchwin routine marks all lines in the window as
- unchanged since the last call to wrefresh.
-
- The wtouchln routine makes n lines in the window, starting
- at line y, look as if they have (changed=1) or have not
- (changed=0) been changed since the last call to wrefresh.
-
- The is_linetouched and is_wintouched routines return TRUE
- if the specified line/window was modified since the last
- call to wrefresh; otherwise they return FALSE. In addi-
- tion, is_linetouched returns ERR if line is not valid for
- the given window.
+
+ The touchwin and touchline routines throw away all optimization infor-
+ mation about which parts of the window have been touched, by pretending
+ that the entire window has been drawn on. This is sometimes necessary
+ when using overlapping windows, since a change to one window affects
+ the other window, but the records of which lines have been changed in
+ the other window do not reflect the change. The routine touchline only
+ pretends that count lines have been changed, beginning with line start.
+ The untouchwin routine marks all lines in the window as unchanged since
+ the last call to wrefresh.
-
-
- All routines return the integer ERR upon failure and an
- integer value other than ERR upon successful completion,
- unless otherwise noted in the preceding routine descrip-
- tions.
+ The wtouchln routine makes n lines in the window, starting at line y,
+ look as if they have (changed=1) or have not (changed=0) been changed
+ since the last call to wrefresh.
+
+ The is_linetouched and is_wintouched routines return TRUE if the speci-
+ fied line/window was modified since the last call to wrefresh; other-
+ wise they return FALSE. In addition, is_linetouched returns ERR if
+ line is not valid for the given window.
- X/Open does not define any error conditions. In this im-
- plementation
+
+
+ All routines return the integer ERR upon failure and an integer value
+ other than ERR upon successful completion, unless otherwise noted in
+ the preceding routine descriptions.
+
+ X/Open does not define any error conditions. In this implementation
is_linetouched
- returns an error if the window pointer is
- null, or if the line number is outside the
- window. Note that ERR is distinct from TRUE
- and FALSE, which are the normal return values
- of this function.
+ returns an error if the window pointer is null, or if the
+ line number is outside the window. Note that ERR is dis-
+ tinct from TRUE and FALSE, which are the normal return val-
+ ues of this function.
wtouchln
- returns an error if the window pointer is
- null, or if the line number is outside the
- window.
+ returns an error if the window pointer is null, or if the
+ line number is outside the window.
-
-
- The XSI Curses standard, Issue 4 describes these func-
- tions.
+
+ The XSI Curses standard, Issue 4 describes these functions.
- Some historic curses implementations had, as an undocu-
- mented feature, the ability to do the equivalent of
- clearok(..., 1) by saying touchwin(stdscr) or clear(std-
- scr). This will not work under ncurses.
+ Some historic curses implementations had, as an undocumented feature,
+ the ability to do the equivalent of clearok(..., 1) by saying touch-
+ win(stdscr) or clear(stdscr). This will not work under ncurses.
-
-
+
Note that all routines except wtouchln may be macros.
-
-
+
curses(3x), curs_refresh(3x), curs_variables(3x).
- curs_touch(3x)
+ curs_touch(3x)