X-Git-Url: http://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fresizeterm.3x.html;h=ffc68b7d1892869873685d8e0fce7d354b5905d0;hp=a41e87e15847e87795d4bee6707cbde49397cf0a;hb=b9a2bd87a73d976d1c916815e2d370bf1090d1b2;hpb=027d0c57c4c4d6690e8d8727888d3282dbe9aa86 diff --git a/doc/html/man/resizeterm.3x.html b/doc/html/man/resizeterm.3x.html index a41e87e1..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.18 2015/04/11 10:23:49 tom Exp @ + * @Id: resizeterm.3x,v 1.20 2015/09/19 22:53:26 tom Exp @ --> @@ -66,12 +66,20 @@ This is an extension to the curses library. It provides callers with a hook into the ncurses data to resize win- dows, primarily for use by programs running in an X Window - terminal (e.g., xterm). The function resizeterm resizes - the standard and current windows to the specified dimen- - sions, and adjusts other bookkeeping data used by the - ncurses library that record the window dimensions such as - the LINES and COLS variables. + terminal (e.g., xterm). + + +
+ The function resizeterm resizes the standard and current + windows to the specified dimensions, and adjusts other + bookkeeping data used by the ncurses library that record + the window dimensions such as the LINES and COLS vari- + ables. + + ++
Most of the work is done by the inner function resize_term. The outer function resizeterm adds bookkeep- ing for the SIGWINCH handler. When resizing the windows, @@ -82,6 +90,9 @@ pads, it is not possible to resize these without addi- tional interaction with the application. + ++
A support function is_term_resized is provided so that applications can check if the resize_term function would modify the window structures. It returns TRUE if the win- @@ -105,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. @@ -135,7 +161,13 @@