panels(3X)                       UNIX System V                       panels(3X)


NAME
      panels - character based panels package

SYNOPSIS
      #include <panel.h>

DESCRIPTION
      The panel library is built using the curses library, and any program
      using panels routines must call one of the curses initialization routines
      such as initscr.  A program using these routines must be compiled with
      -lpanel and -lcurses on the cc command line.

      The panels package gives the applications programmer a way to have depth
      relationships between curses windows; a curses window is associated with
      every panel.  The panels routines allow curses windows to overlap without
      making visible the overlapped portions of underlying windows.  The
      initial curses window, stdscr, lies beneath all panels.  The set of
      currently visible panels is the deck of panels.

      The panels package allows the applications programmer to create panels,
      fetch and set their associated windows, shuffle panels in the deck, and
      manipulate panels in other ways.

   Routine Name Index
      The following table lists each panels routine and the name of the manual
      page on which it is described.
      panels Routine Name    Manual Page Name
      ___________________________________________
      bottom_panel           paneltop(3X)
      del_panel              panelnew(3X)
      hide_panel             panelshow(3X)
      move_panel             panelmove(3X)
      new_panel              panelnew(3X)
      panel_above            panelabove(3X)
      panel_below            panelabove(3X)
      panel_hidden           panelshow(3X)
      panel_userptr          paneluserptr(3X)
      panel_window           panelwindow(3X)
      replace_panel          panelwindow(3X)
      set_panel_userptr      paneluserptr(3X)
      show_panel             panelshow(3X)
      top_panel              paneltop(3X)
      update_panels          panelupdate(3X)

RETURN VALUE
      Each panels routine that returns a pointer to an object returns NULL if
      an error occurs.  Each panel routine that returns an integer, returns OK
      if it executes successfully and ERR if it does not.






10/89                                                                    Page 1

panels(3X)                       UNIX System V                       panels(3X)


NOTES
      The header file <panel.h> automatically includes the header file
      <curses.h>.

SEE ALSO
      curses(3X), and 3X pages whose names begin "panel," for detailed routine
      descriptions.















































Page 2                                                                    10/89