file_decide_c

	status.i4.v = file_decide_c(top_row.i4.v, left_column.i4.v,
				    file_name.i1a.r, num_columns.i4.v,
				    num_rows.i4.v, default_choice.i4.v,
				    text_color.i4.v, title.i1a.r,
				    help_info.s.r, switch_help.sa.r,
				    options.u4.v, search_string.i1a.r,
				    term_string.i1a.r)

	This routine will display a decision window with two choices
	(OK and Cancel) having its upper left hand corner at ("top_row",
	"left_column").  A value of TRUE will be returned if an interrupt
	occurs in the OK field.  Otherwise, a value of FALSE is returned.
	The descriptive text is provided by an ASCII text file.

	top_row		top row of window (use WMNGR_CENTER for centering
			or WINDOW_xxx_COORD macros in macro for special
			positioning)
	left_column	left column of window (use WMNGR_CENTER for centering
			or WINDOW_xxx_COORD macros in macro for special
			positioning)
	file_name	null-terminated string specifing the file
	num_columns	number of columns inside the window  (If a value of 0
			is passed, an optimal window width is found.)
	num_rows	number of rows inside the window  (If a value of 0
			is passed, an optimal window width is found.)
	default_choice	determines the field in which the cursor will
			initially be placed
			(DECIDE_OK -> OK field,
			 DECIDE_CANCEL -> cancel field)
	text_color	message text color (default is GREEN)
			(constants are in 'cnsparam')
	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 the width of the window minus
			four characters.
	help_info	help callback information
			(structure of type HELP_CALLBACK_DATA)
	switch_help	array of two help callback information structures
			for the "OK" and "Cancel" switches
			(array of HELP_CALLBACK_DATA structures)
	options		file read options
			(FILE_VIEW_OPT_NONE -> no options selected,
			 FILE_VIEW_OPT_NO_HTML -> strip HTML code,
			 FILE_VIEW_OPT_EXTRACT_CLIB_HELP -> extract only
							    CLIB-style help,
			 FILE_VIEW_OPT_SKIP_SEARCH -> skip file text preceding
						      the supplied search
						      string,
			 FILE_VIEW_OPT_USE_COLOR_TAGS -> look for embedded
							 color tags in the
							 file text and color
							 the text accordingly)
	search_string	string to search for  (If this argument is supplied
			and the string exists in the file text, the window
			will be scrolled to the first occurrence of the string.)
	term_string	termination string  (If this argument is supplied
			and the string exists in the file text, the file
			read will end when this string is found.)

	This function returns status values as follows:

	TRUE			OK field selected
	FALSE			Cancel field selected
	CBS_MEMFAIL		failed in allocating dynamic memory
	CBS_INVARG		requested window is too large
	CBS_NOTOPN		couldn't open file
	CBS_EMPTY		file was empty
	CBS_WINDOW_TOO_BIG	window won't fit on screen

	This function requires the following include files:

	cnsparam_h, cbslib_h, macro_h, acnet_errors_h

	Related functions:

	decide(_c), decide_multiple_c, file_acknowledge_c, acknowledge(_c),
	file_view_read, window_restore_hint_c, menu_setup_c

	C/C++ usage:

	static const char	file_name[] = "/some_path/file_name.ext";
	static const char	title[] = "Title";
	char	*search_string = (char *) NULL;
	char	*term_string = (char *) NULL;
	int	status;
	int	top_row = WMNGR_CENTER;
	int	left_column = WMNGR_CENTER;
	int	num_columns = 0;
	int	num_rows = 0;
	int	default_choice = DECIDE_OK;
	int	text_color = GREEN;
	unsigned int	options = FILE_VIEW_OPT_NONE;
	HELP_CALLBACK_DATA	*help_info = (HELP_CALLBACK_DATA *) NULL;
	HELP_CALLBACK_DATA	*switch_help = (HELP_CALLBACK_DATA *) NULL;

	status = file_decide_c(top_row,left_column,file_name,num_columns,
			       num_rows,default_choice,text_color,title,
			       help_info,switch_help,options,search_string,
			       term_string);