;
; menu.sh
;
; RISC OS menu handling facilities
;
; © 1994-1998 Straylight
;

;----- Licensing note -------------------------------------------------------
;
; This file is part of Straylight's Sapphire library.
;
; Sapphire is free software; you can redistribute it and/or modify
; it under the terms of the GNU General Public License as published by
; the Free Software Foundation; either version 2, or (at your option)
; any later version.
;
; Sapphire is distributed in the hope that it will be useful,
; but WITHOUT ANY WARRANTY; without even the implied warranty of
; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
; GNU General Public License for more details.
;
; You should have received a copy of the GNU General Public License
; along with Sapphire.  If not, write to the Free Software Foundation,
; 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.

;----- Overview -------------------------------------------------------------
;
; Functions provided:
;
;  menu_create
;  menu_help
;  menu_init

		[	:LNOT::DEF:menu__dfn
		GBLL	menu__dfn

; --- menu_create ---
;
; On entry:	R0 == pointer to menu definition table
;		R1 == event handler to use
;		R2 == R10 value for handler
;		R3 == R12 value for handler
;
; On exit:	--
;
; Use:		Creates a menu from the given menu definition
;		table. If this call is called more than once before
;		a menu is opened then the menu definiton are concatenated
;		into a large menu. Only the first menu title read is
;		taken notice of. Notice therefore, that the call doesn't
;		actually open a menu.

		IMPORT	menu_create

; --- menu_help ---
;
; On entry:	R0 == pointer to base message tag
;		R1 == index of menu item
;
; On exit:	--
;
; Use:		Adds a string to the help message found by adding the menu
;		item number to the base message tag.

		IMPORT	menu_help

; --- menu_init ---
;
; On entry:	--
;
; On exit:	--
;
; Use:		Initialises the menu system.

		IMPORT	menu_init

		]

;----- That's all, folks ----------------------------------------------------

		END