ncurses 5.9 - patch 20141220

[ncurses.git] / doc / html / man / resizeterm.3x.html
diff --git a/doc/html/man/resizeterm.3x.html b/doc/html/man/resizeterm.3x.html

index a7be4795155856b3abfac53e1028fd6a3f8ce9ac..658cc75f1c6976db0adcbbaa5f41ab7a53922e07 100644 (file)
--- a/doc/html/man/resizeterm.3x.html
+++ b/doc/html/man/resizeterm.3x.html
@@ -1,7 +1,7 @@
-<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 2.0//EN">
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN">
  <!-- 
    ****************************************************************************
  <!-- 
    ****************************************************************************
-  * Copyright (c) 1998-2002,2003 Free Software Foundation, Inc.              *
+  * Copyright (c) 1998-2012,2013 Free Software Foundation, Inc.              *
    *                                                                          *
    * Permission is hereby granted, free of charge, to any person obtaining a  *
    * copy of this software and associated documentation files (the            *
    *                                                                          *
    * Permission is hereby granted, free of charge, to any person obtaining a  *
    * copy of this software and associated documentation files (the            *
@@ -27,8 +27,8 @@
    * sale, use or other dealings in this Software without prior written       *
    * authorization.                                                           *
    ****************************************************************************
    * sale, use or other dealings in this Software without prior written       *
    * authorization.                                                           *
    ****************************************************************************
-  * Author: Thomas E. Dickey 1996,1997,2002
-  * @Id: resizeterm.3x,v 1.10 2003/10/25 20:41:08 tom Exp @
+  * Author: Thomas E. Dickey 1996-on
+  * @Id: resizeterm.3x,v 1.17 2013/06/22 20:41:54 tom Exp @
  -->
  <HTML>
  <HEAD>
  -->
  <HTML>
  <HEAD>
@@ -41,7 +41,7 @@
  <HR>
  <PRE>
  <!-- Manpage converted by man2html 3.0.1 -->
  <HR>
  <PRE>
  <!-- Manpage converted by man2html 3.0.1 -->
-<STRONG><A HREF="resizeterm.3x.html">resizeterm(3x)</A></STRONG>                                     <STRONG><A HREF="resizeterm.3x.html">resizeterm(3x)</A></STRONG>
+<STRONG><A HREF="resizeterm.3x.html">resizeterm(3x)</A></STRONG>                                           <STRONG><A HREF="resizeterm.3x.html">resizeterm(3x)</A></STRONG>
  
  
  
  
  
  
@@ -69,30 +69,31 @@
         terminal  (e.g.,  xterm).  The function <STRONG>resizeterm</STRONG> resizes
         the standard and current windows to the  specified  dimen-
         sions,  and  adjusts  other  bookkeeping  data used by the
         terminal  (e.g.,  xterm).  The function <STRONG>resizeterm</STRONG> resizes
         the standard and current windows to the  specified  dimen-
         sions,  and  adjusts  other  bookkeeping  data used by the
-       <STRONG>ncurses</STRONG> library that record the window dimensions.
+       <STRONG>ncurses</STRONG> library that record the window dimensions such  as
+       the <STRONG>LINES</STRONG> and <STRONG>COLS</STRONG> variables.
  
  
-       Most  of  the  work  is  done  by   the   inner   function
+       Most   of   the   work  is  done  by  the  inner  function
         <STRONG>resize_term</STRONG>.  The outer function <STRONG>resizeterm</STRONG> adds bookkeep-
         <STRONG>resize_term</STRONG>.  The outer function <STRONG>resizeterm</STRONG> adds bookkeep-
-       ing for the SIGWINCH handler.  When resizing the  windows,
-       <STRONG>resize_term</STRONG>  blank-fills the areas that are extended.  The
+       ing  for the SIGWINCH handler.  When resizing the windows,
+       <STRONG>resize_term</STRONG> blank-fills the areas that are extended.   The
         calling application should fill in these areas with appro-
         calling application should fill in these areas with appro-
-       priate  data.  The <STRONG>resize_term</STRONG> function attempts to resize
-       all windows.  However, due to the  calling  convention  of
-       pads,  it  is  not  possible to resize these without addi-
+       priate data.  The <STRONG>resize_term</STRONG> function attempts to  resize
+       all  windows.   However,  due to the calling convention of
+       pads, it is not possible to  resize  these  without  addi-
         tional interaction with the application.
  
         tional interaction with the application.
  
-       A support function <STRONG>is_term_resized</STRONG>  is  provided  so  that
-       applications  can  check if the <STRONG>resize_term</STRONG> function would
+       A  support  function  <STRONG>is_term_resized</STRONG>  is provided so that
+       applications can check if the <STRONG>resize_term</STRONG>  function  would
         modify the window structures.  It returns TRUE if the win-
         dows would be modified, and FALSE otherwise.
  
  
  </PRE>
  <H2>RETURN VALUE</H2><PRE>
         modify the window structures.  It returns TRUE if the win-
         dows would be modified, and FALSE otherwise.
  
  
  </PRE>
  <H2>RETURN VALUE</H2><PRE>
-       Except  as  notes,  these  function return the integer <STRONG>ERR</STRONG>
-       upon failure and <STRONG>OK</STRONG> on success.  They will fail if  either
+       Except as noted, these functions return  the  integer  <STRONG>ERR</STRONG>
+       upon  failure and <STRONG>OK</STRONG> on success.  They will fail if either
         of the dimensions are less than or equal to zero, or if an
         of the dimensions are less than or equal to zero, or if an
-       error occurs while (re)allocating memory for the  windows.
+       error occurs while (re)allocating memory for the windows.
  
  
  </PRE>
  
  
  </PRE>
@@ -104,16 +105,21 @@
         tions.
  
         If  ncurses  is configured to supply its own SIGWINCH han-
         tions.
  
         If  ncurses  is configured to supply its own SIGWINCH han-
-       dler, the <STRONG>resizeterm</STRONG> function ungetch's a <STRONG>KEY_RESIZE</STRONG> which
+       dler, the <STRONG>resizeterm</STRONG> function <STRONG>ungetch</STRONG>'s a <STRONG>KEY_RESIZE</STRONG> which
         will  be  read on the next call to <STRONG>getch</STRONG>.  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.
  
         will  be  read on the next call to <STRONG>getch</STRONG>.  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 <STRONG>LINES</STRONG>  or  <STRONG>COLUMNS</STRONG>  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.
+
  
  </PRE>
  <H2>SEE ALSO</H2><PRE>
  
  </PRE>
  <H2>SEE ALSO</H2><PRE>
-       <STRONG><A HREF="wresize.3x.html">wresize(3x)</A></STRONG>.
+       <STRONG><A HREF="curs_getch.3x.html">curs_getch(3x)</A></STRONG>, <STRONG><A HREF="curs_variables.3x.html">curs_variables(3x)</A></STRONG>, <STRONG><A HREF="wresize.3x.html">wresize(3x)</A></STRONG>.
  
  
  </PRE>
  
  
  </PRE>
@@ -123,12 +129,9 @@
  
  
  
  
  
  
-                                                   <STRONG><A HREF="resizeterm.3x.html">resizeterm(3x)</A></STRONG>
+                                                         <STRONG><A HREF="resizeterm.3x.html">resizeterm(3x)</A></STRONG>
  </PRE>
  <HR>
  </PRE>
  <HR>
-<ADDRESS>
-Man(1) output converted with
-<a href="http://www.oac.uci.edu/indiv/ehood/man2html.html">man2html</a>
-</ADDRESS>
+Man(1) output converted with <a href="http://invisible-island.net/scripts/readme.html#others_scripts">man2html</a>
  </BODY>
  </HTML>
  </BODY>
  </HTML>