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

resizeterm

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

resize_term

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

is_term_resized

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