acknowledge(_c)

	status.i4.v = acknowledge(top_row.i4.r, left_column.i4.r, text.i1a.r,
				  text_length.i4.r [,line_length.i4.r]
				  [,text_color.i4.r] [,title.i1a.r]
				  [,word_wrap.i4.r] [,help_info.s.r])

	status.i4.v = acknowledge_c(top_row.i4.v, left_column.i4.v, text.i1a.r,
				    text_length.i4.v [,line_length.i4.v]
				    [,text_color.i4.v] [,title.i1a.r]
				    [,word_wrap.i4.v] [,help_info.s.r])

	This routine will display an acknowledge window with a program-
	supplied message.  The user must click on the "OK" switch to
	resume program activity.  "text" is an informational text string
	while "text_length" is the total length of the message string.  The
	text will be divided into 30 character (default) lines at word
	breakpoints.  Shorter or longer breakpoints can be forced by
	embedding null or new line characters where line breaks are desired.

	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)
	text		informational text string
			(New line characters (\n), can be used for line breaks.
			 '\\c' can be used to center lines of text.)
	text_length	length of text string  (If this value is zero,
			the length of the text string will be determined
			by this routine.  Don't use this feature if there
			are embedded nulls in the text string.)
	[line_length]	number of characters per line (default is 30)
			(If this value is zero, the line length will be
			 determined by this routine.)
	[text_color]	message text color (default is GREEN)
	[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. (default is NULL)
	[word_wrap]	word wrap flag for multiple line messages
			(TRUE -> wrap lines on word boundaries (default),
			 FALSE -> no word wrapping)
	[help_info]	help callback information
			(structure of type HELP_CALLBACK_DATA)
			(default is NULL)

	This function returns ACNET status values as follows:

	OK			success
	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_decide_c, file_view_read,
	calc_line_length_c, dialog_setup_c, window_restore_hint_c

	C/C++ usage:

	static const char	text[] = "Message string";
	static const char	title[] = "Title";
	int		status;
	int		top_row = WMNGR_CENTER;
	int		left_column = WMNGR_CENTER;
	int		text_length = 0;
	int		line_length = 0;
	int		text_color = GREEN;
	int		word_wrap = TRUE;
	HELP_CALLBACK_DATA	*help_info = (HELP_CALLBACK_DATA *) NULL;

	status = acknowledge_c(top_row,left_column,text,text_length,
			       line_length,text_color,title,word_wrap,
			       help_info);