status.i4.v = inptxt(top_row.i4.r, left_column.i4.r,
			     prompt_text.i1a.r, num_chars.i4.r, strings.i1a.r,
			     max_length.i4.r [,num_values.i4.r]
			     [,title.i1a.r] [,num_lines.i4.r]
			     [,key_case.i4.r] [,key_color.i4.r]

	status.i4.v = inptxt_c(top_row.i4.v, left_column.i4.v,
			       prompt_text.i1a.r, num_chars.i4.v, strings.i1a.r,
			       max_length.i4.v [,num_values.i4.v]
			       [,title.i1a.r] [,num_lines.i4.v]
			       [,key_case.i4.v] [,key_color.i4.v]

	This routine will prompt the user to input a text string by
	creating a window on the color TV and displaying a prompt.
	It then waits until the user interrupts, deletes the window, and
	returns the text string to the caller.  The length of the longest
	string input (not counting blanks) is returned.  If any string
	to be entered is longer then the width of the display then
	one must use the string entry routine that supports scrolling
	within the text field.  That routine is input_string_dialog_c.

	top_row		top row of window (use WMNGR_CENTER for centering
			or WINDOW_xxx_COORD macros in macro for special
	left_column	left column of window (use WMNGR_CENTER for centering
			or WINDOW_xxx_COORD macros in macro for special
	prompt_text	prompt text string(s) ("num_values" strings)
	num_chars	number of characters in each prompt string
			(If a value of zero is passed for this argument,
			the routine will automatically determine the prompt
			text length.)
	strings		returned text string(s)
			(Note: If "max_length" is negative and the strings
			 are null terminated, the input length will be
			 decreased by one and the input strings will be
			 null terminated.  If "max_length" is positive,
			 these strings will be treated as being uninitialized
			 and will be space filled by this routine.)
	max_length	maximum length of returned text string (If this is
			negative, a default string is displayed.)
			(maximum is INPTXT_MAX_STRING characters)
	[num_values]	number of strings to input (default is 1)
	[title]		optional window title (default (NULL) is no title)
	[num_lines]	number of lines of input to be displayed at a
			time (default is the number of strings to be input)
	[key_case]	controls case of typed characters
			(WMNGR_UPPER_CASE -> only upper case displayed,
			 WMNGR_MIXED_CASE -> allows lower case (default))
	[key_color]	color of echoed characters (default is RED)
	[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		requested string length is too long
				or invalid number of strings
	CBS_WINDOW_TOO_BIG	window won't fit on the screen
	CBS_MEMFAIL		dynamic memory allocation failure
	CBS_ABORT		user aborted input (no values were changed)
	otherwise		length of (longest) input string

	This function requires the following include files:

	cnsparam_h, cbslib_h, clib_h, macro_h, acnet_errors_h

	Related functions:

	input_string_dialog_c, text_edit_window_c, text_edit_dialog_c,
	cns_edit, window_edit_c, winput(_c), window_input_value(_c),
	dialog_setup_c, window_restore_hint_c

	C/C++ usage:

	static char	title[] = "Title";
	static char	prompt_text[] = "String 1String 2String 3";
	int		status;
	int		top_row = WMNGR_CENTER;
	int		left_column = WMNGR_CENTER;
	int		num_chars = 0;
	int		max_length = STRING_LENGTH;
	int		num_values = NUM_STRINGS;
	int		num_lines = NUM_STRINGS;
	int		key_case = WMNGR_MIXED_CASE;
	int		key_color = RED;

	status = inptxt_c(top_row,left_column,prompt_text,num_chars,
			  (char *) strings,max_length,num_values,title,