X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fncurses-intro.html;h=451e7ab4d32dba74f0b72854dd9f9c9fb495476b;hp=1f09a7c2a265b5dc297f6e1947c17610935c1cfb;hb=41068edef084c39be0cecdf949d9b538d925f42c;hpb=55ccd2b959766810cf7db8d1c4462f338ce0afc8 diff --git a/doc/html/ncurses-intro.html b/doc/html/ncurses-intro.html index 1f09a7c2..451e7ab4 100644 --- a/doc/html/ncurses-intro.html +++ b/doc/html/ncurses-intro.html @@ -1,6 +1,33 @@
@@ -887,15 +914,14 @@ Here is some sample code for shellout:ncurses
library provides an experimental signal
-handler, but in general does not catch this signal, because it cannot
-know how you want the screen re-painted. You will usually have to write the
-SIGWINCH handler yourself. Ncurses can give you some help.
+A resize operation in X sends SIGWINCH
to the application running
+under xterm.
-The easiest way to code your SIGWINCH handler is to have it do an
-endwin
, followed by an refresh
and a screen repaint you code
-yourself. The refresh
will pick up the new screen size from the
+The easiest way to handle SIGWINCH
+is to do an endwin
,
+followed by an refresh
and a screen repaint you code
+yourself.
+The refresh
will pick up the new screen size from the
xterm's environment.
That is the standard way, of course (it even works with some vendor's curses
@@ -907,8 +933,17 @@ not resize subwindows which must be shrunk.
are limited to the new screen dimensions, and pads stdscr
with blanks if the screen is larger.
-Finally, ncurses can be configured to provide its own SIGWINCH handler,
-based on resizeterm
.
+The ncurses
library provides a SIGWINCH signal handler,
+which pushes a KEY_RESIZE
via the wgetch() calls.
+When ncurses
returns that code,
+it calls resizeterm
+to update the size of the standard screen's window, repainting that
+(filling with blanks or truncating as needed).
+It also resizes other windows,
+but its effect may be less satisfactory because it cannot
+know how you want the screen re-painted.
+You will usually have to write special-purpose code to handle
+KEY_RESIZE
yourself.
REQ_NEXT_PAGE
from the last page goes to the first, and REQ_PREV_PAGE
from
the first page goes to the last.
-REQ_MOVE_RIGHT
from A will
go to B only if A, B, and C all share the same first line;
otherwise it will skip over B to C.
-