prepare_menu_entries

	max_length.i4.v = prepare_menu_entries(text.i1a.r, single_length.i4.v,
					       num_entries.i4.v
					       [,options.u4.v])

	This routine will prepare a text buffer for use as menu entry text.
	It will read a "text" buffer made up of "num_entries" substrings each
	having a length of "single_length" characters and will return the
	actual length of the longest entry.  It will also replace any
	embedded null characters with blanks.  The arguments are used
	as follows:

	text		"single_length"*"num_entries" text buffer
	single_length	substring length
	num_entries	number of substrings
	[options]	text parsing options
			(MENU_OPT_NONE -> no parsing options selected
					  (default),
			 MENU_OPT_TRUNCATE_BLANKS -> ignore trailing blanks
						     when calculating
						     "max_length")

	This function returns status values as follows:

	length of longest menu entry

	This function requires the following include files:

	cbslib_h

	Related functions:

	build_menu_text, wmenu(_c), popup_menu(_c), scroll_menu(_c),
	combo_menu_c, logical_scroll_menu(_c), menu_create(_c)

	C/C++ usage:

	static const char	text[NUM_ENTRIES][NUM_CHARS] =
	{"Entry 1", "Entry 2", "Entry 3", "Entry 4", "Entry 5", "Entry 6"};
	int	max_length;
	int	single_length = NUM_CHARS;
	int	num_entries = NUM_ENTRIES;
	unsigned int	options = MENU_OPT_NONE;

	max_length = prepare_menu_entries((char *) text,single_length,
					  num_entries,options);