popup_menu(_c)

	exe_func.i4.v = popup_menu(top_row.i4.r, left_column.i4.r,
				   num_items.i4.r, num_chars.i4.r,
				   item_text.i1a.r, title.i1a.r, item.i4.r
				   [,num_columns.i4.r] [,user_funcs.fa.r]
				   [,func_data.ga.r] [,enabl_entries.i1a.r]
				   [,help_info.sa.r])

	exe_func.i4.v = popup_menu_c(top_row.i4.v, left_column.i4.v,
				     num_items.i4.v, num_chars.i4.v,
				     item_text.i1a.r, title.i1a.r, item.i4.r
				     [,num_columns.i4.v] [,user_funcs.fa.r]
				     [,func_data.ga.r] [,enabl_entries.i1a.r]
				     [,help_info.sa.r])

	This routine will prompt the user to select one item out of list of 
	possibities by creating a window on the color TV and displaying the 
	available choices.  It then waits until the user clicks under 
	one of the choices (or somewhere else), deletes the window, and returns 
	the item number selected to the caller.  If the optional argument
	"funcs" is selected, the function specified will be executed before
	returning control to the caller.

	top_row		top row of menu (use WMNGR_CENTER for centering
			or WINDOW_xxx_COORD macros in macro for special
			positioning)
	left_column	left column of menu (use WMNGR_CENTER for centering
			or WINDOW_xxx_COORD macros in macro for special
			positioning)
	num_items	number of menu items
	num_chars	number of characters in a menu item
			(If a value of zero is passed for this argument,
			 the routine will assume that all of the menu text is
			 contained in a single null terminated or descriptor
			 described string and will automatically determine the
			 length of a single menu item by dividing the total
			 string length by the number of items.)
	item_text	array containing text for each menu item
			("num_chars" characters per item)
	title		a null-terminated text string (ie. a quoted literal)
			to be written to the top line of the window  (It may
			be no longer than ("num_chars" + 3) * "num_columns" - 3
			characters in length.)
	item		number of selected item (or zero).  Upon entry the
			text for menu item = "item" will be displayed in
			yellow.  All other item text will be displayed in
			white.  Upon return, "item" will be set to the number
			of the item which the user clicked under. If the
			cursor was not under a item, "item" will have a
			value of zero.
	[num_columns]	number of menu columns (default is 1)
	[user_funcs]	pointers to functions to be called by the menu
			(If this is specified, the function corresponding to
			 a given entry is called when that entry is selected.)
			(default is NULL)
			(called as follows:
			 user_func(func_data.g.v, item.i4.v, item_text.i1a.r))
	[func_data]	pointers to data to be passed to "funcs"
			(default is NULL)
	[enabl_entries]	array of logical flags indicating which menu entries
			are enabled/active (default is NULL which enables
			all menu entries)
			(MENU_ENABLED_ENTRY -> enabled entry (default),
			 MENU_DISABLED_ENTRY -> disabled entry,
			 MENU_SEPARATOR -> separator entry)
	[help_info]	entry by entry help callback information
			(array of HELP_CALLBACK_DATA structures)
			(default is NULL)

	This function returns status values as follows:

	CBS_INVARG		invalid number of items
	CBS_WINDOW_TOO_BIG	menu won't fit on the screen
	TRUE			user function was executed
	FALSE			user function was not executed

	This function requires the following include files:

	cnsparam_h, cbslib_h, macro_h, acnet_errors_h

	Related functions:

	wmenu(_c), scroll_menu(_c), menu_create(_c), logical_scroll_menu(_c),
	menu_setup_c, build_menu_text

	C/C++ usage:

	static const char	item_text[NUM_ITEMS][NUM_CHARS] =
	{"Entry 1", "Entry 2", "Entry 3", "Entry 4", "Entry 5", "Entry 6"};
	static const char	title[] = "Title";
	char	*enabled_entries = (char *) NULL;
	char	*header_line = (char *) NULL;
	int	exec_func;
	int	top_row = WMNGR_CENTER;
	int	left_column = WMNGR_CENTER;
	int	num_items = NUM_ITEMS;
	int	num_chars = NUM_CHARS;
	int	item = 0;
	int	num_columns = 1;
	int	padding_chars = 1;
	popup_menu_function	*user_funcs = (popup_menu_function *) NULL;
	void	**func_data = (void **) NULL;
	HELP_CALLBACK_DATA	*help_info = (HELP_CALLBACK_DATA *) NULL;

	exec_func = popup_menu_c(top_row,left_column,num_items,num_chars,
				 (char *) item_text,title,&item,num_columns,
				 user_funcs,func_data,enabled_entries,
				 help_info);