X-Git-Url: http://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fresizeterm.3x.html;h=ffc68b7d1892869873685d8e0fce7d354b5905d0;hp=2afe12531e7dc66b44236131803e987011a2f15a;hb=b9a2bd87a73d976d1c916815e2d370bf1090d1b2;hpb=4aaab5e7c855d212deaa53608a08de5648fd86f6
diff --git a/doc/html/man/resizeterm.3x.html b/doc/html/man/resizeterm.3x.html
index 2afe1253..ffc68b7d 100644
--- a/doc/html/man/resizeterm.3x.html
+++ b/doc/html/man/resizeterm.3x.html
@@ -27,7 +27,7 @@
* authorization. *
****************************************************************************
* Author: Thomas E. Dickey 1996-on
- * @Id: resizeterm.3x,v 1.19 2015/06/06 23:38:18 tom Exp @
+ * @Id: resizeterm.3x,v 1.20 2015/09/19 22:53:26 tom Exp @
-->
@@ -116,15 +116,30 @@
tions.
If ncurses is configured to supply its own SIGWINCH han-
- dler, the resizeterm function ungetch's a KEY_RESIZE which
- will be read on the next call to getch. This is used to
- alert an application that the screen size has changed, and
- that it should repaint special features such as pads that
- cannot be done automatically.
-
- If the environment variables LINES or COLUMNS are set,
- this overrides the library's use of the window size
- obtained from the operating system. Thus, even if a SIG-
+ dler,
+
+ o on receipt of a SIGWINCH, the handler sets a flag
+
+ o which is tested in wgetch and doupdate,
+
+ o in turn, calling the resizeterm function,
+
+ o which ungetch's a KEY_RESIZE which will be read on the
+ next call to wgetch.
+
+ The KEY_RESIZE alerts an application that the screen
+ size has changed, and that it should repaint special
+ features such as pads that cannot be done automati-
+ cally.
+
+ Calling resizeterm or resize_term directly from a sig-
+ nal handler is unsafe. This indirect method is used
+ to provide a safe way to resize the ncurses data
+ structures.
+
+ If the environment variables LINES or COLUMNS are set,
+ this overrides the library's use of the window size
+ obtained from the operating system. Thus, even if a SIG-
WINCH is received, no screen size change may be recorded.