
The included source is a menu popup library. The code has been
tested in all resolutions on both the Atari ST and the Atari STe.
Also provided is the source and executable of a sample program,
intended as an example of use, showing most of the capabilities
of the library.

At compile time the user can decide whether the library should
dynamically check for the dereferencing of null pointers. This
is advised during the development of a menu. The production
version can be compiled with the MENU_TRUSTME set to 1. Amongst
others, this will replace some functions with macros.


	Jan van der Steen
	(jansteen@cwi.nl)


From the manual page:

-=-=-=-=-=-=-=-=-=-=-=-=-=-= stmenu.man =-=-=-=-=-=-=-=-=-=-=-=-=-=-
DESCRIPTION
	The menu_...() functions provide the user with a conveniant
	interface to create and handle so called popup menus (menus
	displayed at the location of the mouse).
	The menus can be managed both in pull- or dropdown fashion.
	Menus can have submenus (10 levels).

	The menu tree can be changed dynamically with:

		function		explanation
		---------------------------------------------
		menu_add()		add an item
		menu_child_add()	add a submenu
		menu_delete()		delete an item
		menu_child_delete()	delete a submenu


	Each menu item has the following list of attributes associated
	with it:

		attribute		set/change with
		-----------------------------------------
		title			menu_title     ()
		check mark		menu_check     ()
		submenu			menu_add_child ()
		callback function	menu_callback  ()
		enabled			menu_enable    ()
		font			menu_font      ()
		pointsize		menu_size      ()


	The user can supply a callback function to each menu item.
	This function will be executed by the library once the item
	has been selected.

	The code returned by menu_handle() indicates whether or not a
	choice has actually been made.

	For a "real world" usage of the library see file sample.c.
-=-=-=-=-=-=-=-=-=-=-=-=-=-= stmenu.man =-=-=-=-=-=-=-=-=-=-=-=-=-=-

