/*
 * warning.h
 *
 * [Generated from warning, 25 September 1996]
 */

#if !defined(__CC_NORCROFT) || !defined(__arm)
  #error You must use the Norcroft ARM Compiler for Sapphire programs
#endif1

#pragma include_only_once
#pragma force_top_level

#ifndef __warning_h
#define __warning_h

#ifndef __sapphire_h
  #include "sapphire.h"
#endif

/*----- Overview ----------------------------------------------------------*
 *
 * Functions provided:
 *
 *  warning
 *  warn_init
 */

/* --- warning --- *
 *
 * On entry:	R0 == pointer to warning text to display
 *		R1 == pointer to buttons block
 *
 * On exit:	R0 == button that was clicked
 *		CS if this was default, CC otherwise
 *
 * Use:		Displays a warning to the user.  The warning box can have up
 *		to five buttons (because it's too small for any more than
 *		that).  These are placed in a column on the right hand side
 *		of the dialogue.  The buttons are numbered from 0 up to 4
 *		from the bottom upwards, 0 being the default.  You can
 *		choose one button to be `Cancel', in which case pressing
 *		escape will activate it.
 */

extern routine warning;

/* --- warn_init --- *
 *
 * On entry:	R0 == program name
 *
 * On exit:	--
 *
 * Use:		Sets up the Warning dialogue box for use.
 */

extern routine warn_init;

/*----- That's all, folks -------------------------------------------------*/

#endif
