/**
 * Retrieves info about a menu item.
 *
 * @param menu            Menu resource identifier.
 * @param item            Item identifier.
 * @param access        Variable to store access value.
 * @param info            Buffer to store item info.
 * @param infolen        Item info buffer length.
 * @param name            Buffer to store item display text.
 * @param namelen        Item name buffer length.
 * @param callback        Callback ID.
 * @return                1 on success, 0 on failure.
 * @error                Invalid menu resource.
 */

/**
 * Given a page on a menu and a keypress on that page, returns the item id selected.
 * If the item is less than 0, a special option was chosen (such as MENU_EXIT).
 *
 * @param menu            Menu resource identifier.
 * @param page            Page on the menu.
 * @param key            Key pressed (from 1 to 10).
 * @return                Item identifier, or <0 for a special selection code.
 * @error                Invalid menu resource.
 */

/**
 * Destroys a menu.  Player menus will be cancelled (although may still linger 
 * on the HUD), and future attempts to access the menu resource will result in 
 * an error.
 *
 * This must be called if you create menus dynamically, otherwise you will 
 * leak memory.  For normal dynamic menus, you will destroy the menu in the 
 * handler function (remembering to handle the case of a menu being cancelled, 
 * it must still be destroyed).
 *
 * @param menu            Menu resource identifier.
 * @noreturn
 * @error                Invalid menu resource.
 */