dio_ext_text(_c)

	status.i4.v = dio_ext_text(device_indices.i4a.r, num_entries.i4a.r,
				   bit_numbers.i4a.r, text_if_0.i1a.r,
				   color_if_0.i4a.r, text_if_1.i1a.r,
				   color_if_1.i4a.r, text.i1a.r, errors.i2a.r
				   [,max_entries.i4.r] [,num_devices.i4.r])

	status.i4.v = dio_ext_text_c(device_indices.i4a.r, num_entries.i4a.r,
				     bit_numbers.i4a.r, text_if_0.i1a.r,
				     color_if_0.i4a.r, text_if_1.i1a.r,
				     color_if_1.i4a.r, text.i1a.r, errors.i2a.r
				     [,max_entries.i4.v] [,num_devices.i4.v])

	This routine returns extended text information for a device.
	The number of text entries is returned in "num_entries".  The short
	text strings and their colors for bit states 0 and 1 are returned in
	"text_if_x" and "color_if_x" respectively.  The status bit number
	corresponding to the text is returned in "bit_numbers", and the
	descriptive text is returned in "text".  If "max_entries" is
	specified, the number of entries per device returned will be limited
	to that number.  "num_entries", however, will always contain the
	number of entries in the database for the corresponding device.  If
	"num_devices" is specified, extended text information for a list of
	devices can be retrieved.

	device_indices	device index or array of device indices
	num_entries	returned number of extended text entries or array of
			number of text entries (A value of NULL may be passed
			if no entry counts are needed.)
	bit_numbers	returned array of corresponding basic status bit
			numbers (values start at 0) (A value of NULL may be
			passed if no bit numbers are needed.)
	text_if_0	returned condition text if bit is 0
			(DIO_COND_EXT_TEXT_LEN characters per entry)
			(A value of NULL may be passed if no text is needed.)
	color_if_0	returned color code if bit is 0
			(constants are in 'cnsparam') (A value of NULL may
			be passed if no colors are needed.)
	text_if_1	returned condition text if bit is 1
			(DIO_COND_EXT_TEXT_LEN characters per entry)
			(A value of NULL may be passed if no text is needed.)
	color_if_1	returned color code if bit is 1
			(constants are in 'cnsparam') (A value of NULL may be
			passed if no colors are needed.)
	text		returned descriptive text
			(DIO_EXT_TEXT_LEN characters plus a null terminator
			 per entry)
			(A value of NULL may be passed if no text is needed.)
	errors		returned ACNET status value or array of status values
	[max_entries]	maximum number of text entries allowed per device
			(default is 256 entries)
	[num_devices]	number of devices (default is 1)

	This function returns status values as follows:

	OK			success
	DIO_BADARG		invalid number of devices passed
	DIO_MEMFAIL		memory allocation failure
	negative value		ACNET format error indicating overall failure
	positive value		number of devices in error indicating partial
				success

	This function requires the following include files:

	cnsparam_h, diolib_h, acnet_errors_h

	Related functions:

	dio_status_attr_to_bit_info_c, dio_digital_alarm_text(_c),
	dio_dev_text(_c), dio_analog_alarm_text(_c), error_in_list(_c)

	C/C++ usage:

	char	text_if_0[NUM_DEVICES*MAX_ENTRIES*DIO_COND_EXT_TEXT_LEN];
	char	text_if_1[NUM_DEVICES*MAX_ENTRIES*DIO_COND_EXT_TEXT_LEN];
	char	text[NUM_DEVICES*MAX_ENTRIES*(DIO_EXT_TEXT_LEN+1)];
	short	errors[NUM_DEVICES];
	int	status;
	static const int	device_indices[NUM_DEVICES] = {14430, 14431};
	int	num_entries[NUM_DEVICES];
	int	bit_numbers[NUM_DEVICES*MAX_ENTRIES];
	int	color_if_0[NUM_DEVICES*MAX_ENTRIES];
	int	color_if_1[NUM_DEVICES*MAX_ENTRIES];
	int	max_entries = MAX_ENTRIES;
	int	num_devices = NUM_DEVICES;

	status = dio_ext_text_c(device_indices,num_entries,bit_numbers,
				text_if_0,color_if_0,text_if_1,color_if_1,
				text,errors,max_entries,num_devices);