NAME
	InvertString -- produce input events that would generate the
			given string. (V36)

   SYNOPSIS
	events = InvertString(str,km)

	struct InputEvent *InvertString(STRPTR,struct KeyMap *);

   FUNCTION
	This function returns a linked list of input events which would
	translate into the string using the supplied keymap (or the system
	default keymap if 'km' is NULL).

	'str' is null-terminated and may contain:
	   - ANSI character codes
	   - backslash escaped characters:
		n   -   CR
		r   -   CR
		t   -   TAB
		0   -   illegal, do not use!
		\   -   backslash
	   - a text description of an input event as used by ParseIX(),
	     enclosed in angle brackets.

	An example is:
          abc<alt f1>nhi there.

   INPUTS
	str - null-terminated string to convert to input events
	km - keymap to use for the conversion, or NULL to use the default
	     keymap.

   RESULTS
	events - a chain of input events, or NULL if there was a problem. The
		 most likely cause of failure is an illegal description
		 enclosed in angled brackets.

		 This chain should eventually be freed using FreeIEvents().

   SEE ALSO
	commodities.library/ParseIX(), FreeIEvents()