]> ncurses.scripts.mit.edu Git - ncurses.git/blobdiff - doc/html/man/curs_sp_funcs.3x.html
ncurses 5.8 - patch 20110226
[ncurses.git] / doc / html / man / curs_sp_funcs.3x.html
index ab73bce4b765b1f4ceeab5a75d728505de7e174b..a11947a74abddb09699984dbdcee430375577c82 100644 (file)
        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>.