X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_refresh.3x.html;h=035591d04adb5920472bd350f9248c1a00e8193c;hp=c16d3389fdb3a31764acdbf3aedc377e1d4da8c4;hb=81304798ee736c467839c779c9ca5dca48db7bea;hpb=bca50d0d8592defee6c584fdedd25f4b1a31345b diff --git a/doc/html/man/curs_refresh.3x.html b/doc/html/man/curs_refresh.3x.html index c16d3389..035591d0 100644 --- a/doc/html/man/curs_refresh.3x.html +++ b/doc/html/man/curs_refresh.3x.html @@ -1,6 +1,7 @@ - @@ -34,7 +35,7 @@ curs_refresh 3x - + @@ -54,11 +55,12 @@ #include <curses.h> int refresh(void); - int wrefresh(WINDOW *win); - int wnoutrefresh(WINDOW *win); + int wrefresh(WINDOW *win); + int wnoutrefresh(WINDOW *win); int doupdate(void); - int redrawwin(WINDOW *win); - int wredrawln(WINDOW *win, int beg_line, int num_lines); + + int redrawwin(WINDOW *win); + int wredrawln(WINDOW *win, int beg_line, int num_lines);

DESCRIPTION

@@ -67,32 +69,42 @@
        The refresh and wrefresh routines (or wnoutrefresh and  doupdate)  must
        be called to get actual output to the terminal, as other routines mere-
        ly manipulate data structures.  The routine wrefresh copies  the  named
-       window to the physical terminal screen, taking into account what is al-
-       ready there to do optimizations.  The refresh routine is the same,  us-
-       ing stdscr as the default window.  Unless leaveok has been enabled, the
-       physical cursor of the terminal is left at the location of  the  cursor
-       for that window.
+       window  to  the  physical  screen,  taking into account what is already
+       there to do optimizations.  The refresh routine is the same, using std-
+       scr as the default window.  Unless leaveok has been enabled, the physi-
+       cal cursor of the terminal is left at the location of  the  cursor  for
+       that window.

wnoutrefresh/doupdate

        The wnoutrefresh and doupdate routines allow multiple updates with more
        efficiency than wrefresh alone.  In addition to all the  window  struc-
        tures,  curses  keeps  two  data  structures  representing the terminal
-       screen: a physical screen, describing what is actually on  the  screen,
-       and  a  virtual screen, describing what the programmer wants to have on
-       the screen.
-
-       The routine wrefresh works by first calling wnoutrefresh, which  copies
-       the  named  window  to  the  virtual screen, and then calling doupdate,
-       which compares the virtual screen to the physical screen and  does  the
-       actual  update.   If the programmer wishes to output several windows at
-       once, a series of calls to wrefresh results  in  alternating  calls  to
-       wnoutrefresh  and  doupdate,  causing  several  bursts of output to the
-       screen.  By first calling wnoutrefresh for each window, it is then pos-
-       sible  to  call  doupdate  once, resulting in only one burst of output,
-       with fewer total characters transmitted and less CPU time used.  If the
-       win  argument  to wrefresh is the global variable curscr, the screen is
-       immediately cleared and repainted from scratch.
+       screen:
+
+       o   a physical screen, describing what is actually on the screen, and
+
+       o   a virtual screen, describing what the programmer wants to  have  on
+           the screen.
+
+       The routine wrefresh works by
+
+       o   first  calling  wnoutrefresh,  which copies the named window to the
+           virtual screen, and
+
+       o   then calling doupdate, which compares the  virtual  screen  to  the
+           physical screen and does the actual update.
+
+       If the programmer wishes to output several windows at once, a series of
+       calls to wrefresh results in  alternating  calls  to  wnoutrefresh  and
+       doupdate,  causing  several  bursts  of output to the screen.  By first
+       calling wnoutrefresh for each window, it is then possible to call doup-
+       date  once,  resulting  in  only  one burst of output, with fewer total
+       characters transmitted and less CPU time used.
+
+       If the win argument to wrefresh is the physical screen (i.e., the glob-
+       al  variable  curscr),  the screen is immediately cleared and repainted
+       from scratch.
 
        The phrase "copies the named window to the virtual screen" above is am-
        biguous.   What actually happens is that all touched (changed) lines in