##############################################################################
###+--------------+###########################################################
#+-| RESTORE_MENU |---------------------------------------------------+#######
#| +--------------+ Restores a menu saved by the save_menu() function |#######
#+--------------------------------------------------------------------+#######
##############################################################################
##############################################################################
#+--| Summary |------------+##################################################
#|     #INCLUDE io.hdr     |##################################################
#+-------------------------+##################################################
##############################################################################
##############################################################################
#+--| Syntax |-------------------------------+################################
#|     PROCEDURE restore_menu PROTOTYPE      |################################
#|      PARAMETERS CONST CHAR saved_menu     |################################
#+-------------------------------------------+################################
##############################################################################
##############################################################################
#########+---| Description |---------------------------------------+##########
#########| This procedure restores a menu saved by the save_menu() |##########
#########| function.  saved_menu is the variable used for the      |##########
#########| original call to save_menu().                           |##########
#########+---------------------------------------------------------+##########
##############################################################################
##############################################################################
#########+--| Example 1 |-------------------------------------------+#########
#########| *    Save a menu prior to initiating another menu...     |#########
#########|                                                          |#########
#########| VARDEF                                                   |#########
#########|     CHAR(14)     smenu                                   |#########
#########|     INT          z                                       |#########
#########| ENDDEF                                                   |#########
#########|                                                          |#########
#########|     {...}                                                |#########
#########|     smenu = save_menu()                                  |#########
#########|     @ 14,3 PROMPT "Next" ID 1                            |#########
#########|     @ 14,9 PROMPT "Quit" ID 2                            |#########
#########|     MENU TO z                                            |#########
#########|     IF z = 2                                             |#########
#########|         restore_menu( smenu )                            |#########
#########|         RETURN                                           |#########
#########|     ENDIF                                                |#########
#########|                                                          |#########
#########|     {...}                                                |#########
#########+----------------------------------------------------------+#########
##############################################################################