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.
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