X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_refresh.3x.html;fp=doc%2Fhtml%2Fman%2Fcurs_refresh.3x.html;h=cfb75eba9fae48418c4698205b50a26dec28f93d;hp=c16d3389fdb3a31764acdbf3aedc377e1d4da8c4;hb=17c5992a16be94247b83f2bbb9accdd9b7e7bb72;hpb=6941ed1e8bfdfc7634a57655dc71e7a7ed02a6e8 diff --git a/doc/html/man/curs_refresh.3x.html b/doc/html/man/curs_refresh.3x.html index c16d3389..cfb75eba 100644 --- a/doc/html/man/curs_refresh.3x.html +++ b/doc/html/man/curs_refresh.3x.html @@ -1,6 +1,6 @@ @@ -67,32 +67,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