]> ncurses.scripts.mit.edu Git - ncurses.git/blobdiff - doc/html/man/curs_sp_funcs.3x.html
ncurses 5.9 - patch 20130518
[ncurses.git] / doc / html / man / curs_sp_funcs.3x.html
index a11947a74abddb09699984dbdcee430375577c82..ac189bd60fe4aaf95df60aaf34b1d0dcb8c210d9 100644 (file)
@@ -1,4 +1,4 @@
-<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 2.0//EN">
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN">
 <!-- 
   ****************************************************************************
   * Copyright (c) 2010 Free Software Foundation, Inc.                        *
 <!-- 
   ****************************************************************************
   * Copyright (c) 2010 Free Software Foundation, Inc.                        *
        functions which improve the  ability  to  manage  multiple
        screens.  This feature can be added to any of the configu-
        rations supported by  ncurses;  it  adds  new  entrypoints
        functions which improve the  ability  to  manage  multiple
        screens.  This feature can be added to any of the configu-
        rations supported by  ncurses;  it  adds  new  entrypoints
-       without  changing the meaning of any of the existing ones.
-
+       without changing the meaning of any of the existing ones.
 
    <STRONG>IMPROVED</STRONG> <STRONG>FUNCTIONS</STRONG>
 
    <STRONG>IMPROVED</STRONG> <STRONG>FUNCTIONS</STRONG>
-       Most of the functions are new versions of  existing  func-
+       Most  of  the functions are new versions of existing func-
        tions.  A parameter is added at the front of the parameter
        list.  It is a SCREEN pointer.
 
        tions.  A parameter is added at the front of the parameter
        list.  It is a SCREEN pointer.
 
-       The existing functions all use the current  screen,  which
-       is  a  static  variable.   The  extended functions use the
+       The  existing  functions all use the current screen, which
+       is a static variable.   The  extended  functions  use  the
        specified screen, thereby reducing the number of variables
        which must be modified to update multiple screens.
 
        specified screen, thereby reducing the number of variables
        which must be modified to update multiple screens.
 
        Here are the new functions:
 
        ceiling_panel
        Here are the new functions:
 
        ceiling_panel
-            this  returns  a  pointer to the topmost panel in the
+            this returns a pointer to the topmost  panel  in  the
             given screen.
 
        ground_panel
             given screen.
 
        ground_panel
-            this returns a pointer to the  lowest  panel  in  the
+            this  returns  a  pointer  to the lowest panel in the
             given screen.
 
        new_prescr
             given screen.
 
        new_prescr
-            when  creating  a new screen, the library uses static
-            variables  which   have   been   preset,   e.g.,   by
+            when creating a new screen, the library  uses  static
+            variables   which   have   been   preset,   e.g.,  by
             <STRONG><A HREF="use_env.3x.html">use_env(3x)</A></STRONG>, <STRONG><A HREF="filter.3x.html">filter(3x)</A></STRONG>, etc.  With the screen-point-
             er extension, there are situations where it must cre-
             <STRONG><A HREF="use_env.3x.html">use_env(3x)</A></STRONG>, <STRONG><A HREF="filter.3x.html">filter(3x)</A></STRONG>, etc.  With the screen-point-
             er extension, there are situations where it must cre-
-            ate  a  current  screen before the unextended library
-            does.  The <STRONG>new_prescr</STRONG> function is used internally  to
+            ate a current screen before  the  unextended  library
+            does.   The <STRONG>new_prescr</STRONG> function is used internally to
             handle these cases.  It is also provided as an entry-
             handle these cases.  It is also provided as an entry-
-            point to allow applications to customize the  library
+            point  to allow applications to customize the library
             initialization.
 
 
             initialization.
 
 
        This extension introduces some new names:
 
        NCURSES_SP_FUNCS
        This extension introduces some new names:
 
        NCURSES_SP_FUNCS
-            This  is  set  to the library patch-level number.  In
-            the unextended library, this is zero (0), to make  it
+            This is set to the library  patch-level  number.   In
+            the  unextended library, this is zero (0), to make it
             useful for checking if the extension is provided.
 
        NCURSES_SP_NAME
             useful for checking if the extension is provided.
 
        NCURSES_SP_NAME
-            The  new  functions  are named using the macro <EM>NCURS-</EM>
-            <EM>ES</EM><STRONG>_</STRONG><EM>SP</EM><STRONG>_</STRONG><EM>NAME</EM>, which hides  the  actual  implementation.
+            The new functions are named using  the  macro  <EM>NCURS-</EM>
+            <EM>ES</EM><STRONG>_</STRONG><EM>SP</EM><STRONG>_</STRONG><EM>NAME</EM>,  which  hides  the actual implementation.
             Currently this adds a "_sp" suffix to the name of the
             Currently this adds a "_sp" suffix to the name of the
-            unextended function.  This manual  page  indexes  the
+            unextended  function.   This  manual page indexes the
             extensions showing the full name.  However the proper
             extensions showing the full name.  However the proper
-            usage of these functions uses the macro,  to  provide
+            usage  of  these functions uses the macro, to provide
             for the possibility of changing the naming convention
             for specific library configurations.
 
        NCURSES_SP_OUTC
             for the possibility of changing the naming convention
             for specific library configurations.
 
        NCURSES_SP_OUTC
-            This is a new function-pointer type  to  use  in  the
-            screen-pointer  functions  where  an  <EM>NCURSES</EM><STRONG>_</STRONG><EM>OUTC</EM> is
+            This  is  a  new  function-pointer type to use in the
+            screen-pointer functions  where  an  <EM>NCURSES</EM><STRONG>_</STRONG><EM>OUTC</EM>  is
             used in the unextended library.
 
        NCURSES_OUTC
             used in the unextended library.
 
        NCURSES_OUTC
-            This is a function-pointer type used  for  the  cases
-            where  a  function  passes  characters  to the output
+            This  is  a  function-pointer type used for the cases
+            where a function  passes  characters  to  the  output
             stream, e.g., <STRONG><A HREF="vidputs.3x.html">vidputs(3x)</A></STRONG>.
 
 
             stream, e.g., <STRONG><A HREF="vidputs.3x.html">vidputs(3x)</A></STRONG>.
 
 
-
 </PRE>
 <H2>PORTABILITY</H2><PRE>
 </PRE>
 <H2>PORTABILITY</H2><PRE>
-       These routines are specific to  ncurses.   They  were  not
-       supported  on  Version 7, BSD or System V implementations.
-       It is recommended that any code depending on  ncurses  ex-
+       These  routines  are  specific  to ncurses.  They were not
+       supported on Version 7, BSD or System  V  implementations.
+       It  is  recommended that any code depending on ncurses ex-
        tensions be conditioned using <EM>NCURSES</EM><STRONG>_</STRONG><EM>SP</EM><STRONG>_</STRONG><EM>FUNCS</EM>.
 
 
        tensions be conditioned using <EM>NCURSES</EM><STRONG>_</STRONG><EM>SP</EM><STRONG>_</STRONG><EM>FUNCS</EM>.