NAME
     copa - 1.0 gui control panel / graph kit for shell, C, perl,
     etc.
 
SYNOPSIS
     copa_window [win_x win_y width height title bkclr]
 
     copa [command] [args]
 
DESCRIPTION
     Copa (control panel kit) is an attempt to  reduce  a  useful
     amount  of graphical user interface (GUI) functionality down
     to a small self-contained command set which can be used pro-
     cedurally.   Copa includes mechanisms such as buttons, slid-
     ers, text/list boxes, data entry areas,  and  various  data-
     driven  plots;  and  may  be  used  from shell scripts, perl
     scripts, C programs, and other languages. It is optimized to
     easily  issue  and capture the output of system commands for
     browsing or point/click selection.  Copa may be  useful  for
     tasks  such  as adding gui control functionality to existing
     programs, and creating quick gui-based  help  systems,  data
     browsing/analysis tools, or system administration utilities.
     It is intended to be small and  easy  to  use  but  flexible
     enough to be useful for many situations, so that interactive
     point-and-click applications can  be  prototyped  and  built
     quickly  in  the  user's language of choice, without windows
     programming expertise.
 
ENVIRONMENT
     Copa can be used from shell scripts, perl programs,  or  any
     language  environment  which  can  execute  (and capture the
     standard output of) system commands.  This man  page  covers
     the  use  of  copa  in this mode.  For use within C programs
     compiled using the copa.a library, see the copa(3) man page.
 
     Copa requires X windows (xlib), and  was  developed  on  Sun
     Solaris 2.x and SunOX 4.x environments.
 
     The environment variable COPA_HOME must be defined  to  hold
     the  full  name  of  the  directory  where  copa  files  are
     installed. In order to handle multiple sessions by the  same
     userid,  the variable COPA_PIPE must be defined uniquely for
     each session.
 
EXAMPLE
	#!/bin/sh
	
	copa_window &
	sleep 1
	
	ANS=`copa pop "Do you like my hat?" "I Do,I Do Not"`
	echo $ANS
	
	ANS=`copa poplist "Select a file:" "!ls" "Cancel" `
	echo $ANS
	
	copa panload examples/examp1.pan e1
	
	ANS=`copa get`
	echo $ANS
	
	copa quit


     Some examples in C, bourne sh, and perl are in ./examples.

AUTHOR
     Stephen C. Grubb, The Johns Hopkins University
