<!-- ##### SECTION Title ##### -->
gnome-app-helper

<!-- ##### SECTION Short_Description ##### -->
Useful functions for populating menus and toolbars.

<!-- ##### SECTION Long_Description ##### -->
<para>
This module lets a developer easily create menus and toolbars for use in their
applications. Basically, a hierarchy of #GnomeUIInfo structures are defined and
then the appropriate functions from this module are called to create the menu
or tool bars.
</para>

<!-- ##### SECTION See_Also ##### -->
<para>

</para>

<!-- ##### SECTION Stability_Level ##### -->


<!-- ##### ENUM GnomeUIInfoType ##### -->
<para>

</para>

@GNOME_APP_UI_ENDOFINFO: 
@GNOME_APP_UI_ITEM: 
@GNOME_APP_UI_TOGGLEITEM: 
@GNOME_APP_UI_RADIOITEMS: 
@GNOME_APP_UI_SUBTREE: 
@GNOME_APP_UI_SEPARATOR: 
@GNOME_APP_UI_HELP: 
@GNOME_APP_UI_BUILDER_DATA: 
@GNOME_APP_UI_ITEM_CONFIGURABLE: 
@GNOME_APP_UI_SUBTREE_STOCK: 
@GNOME_APP_UI_INCLUDE: 

<!-- ##### ENUM GnomeUIInfoConfigurableTypes ##### -->
<para>

</para>

@GNOME_APP_CONFIGURABLE_ITEM_NEW: 
@GNOME_APP_CONFIGURABLE_ITEM_OPEN: 
@GNOME_APP_CONFIGURABLE_ITEM_SAVE: 
@GNOME_APP_CONFIGURABLE_ITEM_SAVE_AS: 
@GNOME_APP_CONFIGURABLE_ITEM_REVERT: 
@GNOME_APP_CONFIGURABLE_ITEM_PRINT: 
@GNOME_APP_CONFIGURABLE_ITEM_PRINT_SETUP: 
@GNOME_APP_CONFIGURABLE_ITEM_CLOSE: 
@GNOME_APP_CONFIGURABLE_ITEM_QUIT: 
@GNOME_APP_CONFIGURABLE_ITEM_CUT: 
@GNOME_APP_CONFIGURABLE_ITEM_COPY: 
@GNOME_APP_CONFIGURABLE_ITEM_PASTE: 
@GNOME_APP_CONFIGURABLE_ITEM_CLEAR: 
@GNOME_APP_CONFIGURABLE_ITEM_UNDO: 
@GNOME_APP_CONFIGURABLE_ITEM_REDO: 
@GNOME_APP_CONFIGURABLE_ITEM_FIND: 
@GNOME_APP_CONFIGURABLE_ITEM_FIND_AGAIN: 
@GNOME_APP_CONFIGURABLE_ITEM_REPLACE: 
@GNOME_APP_CONFIGURABLE_ITEM_PROPERTIES: 
@GNOME_APP_CONFIGURABLE_ITEM_PREFERENCES: 
@GNOME_APP_CONFIGURABLE_ITEM_ABOUT: 
@GNOME_APP_CONFIGURABLE_ITEM_SELECT_ALL: 
@GNOME_APP_CONFIGURABLE_ITEM_NEW_WINDOW: 
@GNOME_APP_CONFIGURABLE_ITEM_CLOSE_WINDOW: 
@GNOME_APP_CONFIGURABLE_ITEM_NEW_GAME: 
@GNOME_APP_CONFIGURABLE_ITEM_PAUSE_GAME: 
@GNOME_APP_CONFIGURABLE_ITEM_RESTART_GAME: 
@GNOME_APP_CONFIGURABLE_ITEM_UNDO_MOVE: 
@GNOME_APP_CONFIGURABLE_ITEM_REDO_MOVE: 
@GNOME_APP_CONFIGURABLE_ITEM_HINT: 
@GNOME_APP_CONFIGURABLE_ITEM_SCORES: 
@GNOME_APP_CONFIGURABLE_ITEM_END_GAME: 

<!-- ##### MACRO GNOME_APP_CONFIGURABLE_ITEM_EXIT ##### -->
<para>
The <literal>EXIT</literal> and <literal>QUIT</literal> commands are synonyms
(they were used interchangably and inconsistently in GNOME 1). This define
just makes this the case for configurable menu items as well. Note, however,
that in GNOME 2, the use of <emphasis>exit</emphasis> is deprecated and all new
applications should use the word <emphasis>quit</emphasis> whenever termination
of an application is being discussed.
</para>



<!-- ##### ENUM GnomeUIPixmapType ##### -->
<para>

</para>

@GNOME_APP_PIXMAP_NONE: 
@GNOME_APP_PIXMAP_STOCK: 
@GNOME_APP_PIXMAP_DATA: 
@GNOME_APP_PIXMAP_FILENAME: 

<!-- ##### STRUCT GnomeUIInfo ##### -->
<para>
This is the structure that defines an item in a menu bar or toolbar.  The 
idea is to create an array of such structures with the information needed 
to create menus or toolbars. The most convenient way to create such a 
structure is to use the GNOMEUIINFO_* macros provided below.
</para>

<para>
The @moreinfo parameter contents depend on the @type. For 'item',
'toggleitem' and 'radioitem' types, this is a pointer to the function to
call when the item is activated. For 'subtrees', it is a pointer to another
array of #GnomeUIInfo structures. For 'radioitem lead' entry, it is a
pointer to an array of #GnomeUIInfo structures for the radio item group. For
a 'help' item, it specifies the help node to load (i.e. the application's
identifier) or %NULL for the main program's name. For 'builder data',
@moreinfo points to the #GnomeUIBuilderData structure for the subsequent
items.
</para>

<para>
The contents of the @pixmap_info depend upon the value of @pixmap_type. If
@pixmap_type is @GNOME_APP_PIXMAP_STOCK, then @pixmap_info is a pointer to a
stock icon name. For #GNOME_APP_PIXMAP_DATA pixmaps, @pixmap_info is a
pointer to inline xpm data. For #GNOME_APP_PIXMAP_FILENAME pixmaps, it is a
pointer to the filename string.
</para>

<para>
When @type is #GNOME_APP_UI_ITEM_CONFIGURABLE, @accelerator_key is
overloaded to be the name of the configurable pixmap (an element from the
#GnomeUIInfoConfigurableTypes enum). In this case @ac_mods should be 0.
</para>

<para>
The @widget field in the #GnomeUIInfo structure is filled in by the creation
function. It can be used to tweak the widgets once they have been created if
the application requires that level of fine-grained control.
</para>

@type: 
@label: 
@hint: 
@moreinfo: 
@user_data: 
@unused_data: 
@pixmap_type: 
@pixmap_info: 
@accelerator_key: 
@ac_mods: 
@widget: 

<!-- ##### STRUCT GnomeUIBuilderData ##### -->
<para>

</para>

@connect_func: 
@data: 
@is_interp: 
@relay_func: 
@destroy_func: 

<!-- ##### MACRO GNOMEUIINFO_KEY_UIDATA ##### -->
<para>
The <literal>widget</literal> element in a #GnomeUIInfo structure will have
this parameter set to the user data that was given in the #GnomeUIInfo instance.
</para>



<!-- ##### MACRO GNOMEUIINFO_KEY_UIBDATA ##### -->
<para>
The <literal>widget</literal> element in a #GnomeUIInfo structure will have
this parameter set to the user data that was given in the relevant
#GnomeUIBuilderData structure that was applicable at the time of construction
of the widget.
</para>



<!-- ##### USER_FUNCTION GnomeUISignalConnectFunc ##### -->
<para>
The template for functions that are called as a result of signals being emitted
from a menu or tool bar item. Fnuctions of this type are given as the first
element of a #GnomeUIBuilderData instance.
</para>

@uiinfo: The user data that was part of the #GnomeUIInfo instance.
@signal_name: The name of the emitted signal.
@uibdata: The user data that was part of the relevant #GnomeUIBuilderData
instance.


<!-- ##### FUNCTION gnome_accelerators_sync ##### -->
<para>

</para>



<!-- ##### FUNCTION gnome_app_fill_menu ##### -->
<para>

</para>

@menu_shell: 
@uiinfo: 
@accel_group: 
@uline_accels: 
@pos: 


<!-- ##### FUNCTION gnome_app_fill_menu_with_data ##### -->
<para>

</para>

@menu_shell: 
@uiinfo: 
@accel_group: 
@uline_accels: 
@pos: 
@user_data: 


<!-- ##### FUNCTION gnome_app_fill_menu_custom ##### -->
<para>

</para>

@menu_shell: 
@uiinfo: 
@uibdata: 
@accel_group: 
@uline_accels: 
@pos: 


<!-- ##### FUNCTION gnome_app_ui_configure_configurable ##### -->
<para>

</para>

@uiinfo: 


<!-- ##### FUNCTION gnome_app_create_menus ##### -->
<para>

</para>

@app: 
@uiinfo: 


<!-- ##### FUNCTION gnome_app_create_menus_interp ##### -->
<para>

</para>

@app: 
@uiinfo: 
@relay_func: 
@data: 
@destroy_func: 


<!-- ##### FUNCTION gnome_app_create_menus_with_data ##### -->
<para>

</para>

@app: 
@uiinfo: 
@user_data: 


<!-- ##### FUNCTION gnome_app_create_menus_custom ##### -->
<para>

</para>

@app: 
@uiinfo: 
@uibdata: 


<!-- ##### FUNCTION gnome_app_fill_toolbar ##### -->
<para>

</para>

@toolbar: 
@uiinfo: 
@accel_group: 


<!-- ##### FUNCTION gnome_app_fill_toolbar_with_data ##### -->
<para>

</para>

@toolbar: 
@uiinfo: 
@accel_group: 
@user_data: 


<!-- ##### FUNCTION gnome_app_fill_toolbar_custom ##### -->
<para>

</para>

@toolbar: 
@uiinfo: 
@uibdata: 
@accel_group: 


<!-- ##### FUNCTION gnome_app_create_toolbar ##### -->
<para>

</para>

@app: 
@uiinfo: 


<!-- ##### FUNCTION gnome_app_create_toolbar_interp ##### -->
<para>

</para>

@app: 
@uiinfo: 
@relay_func: 
@data: 
@destroy_func: 


<!-- ##### FUNCTION gnome_app_create_toolbar_with_data ##### -->
<para>

</para>

@app: 
@uiinfo: 
@user_data: 


<!-- ##### FUNCTION gnome_app_create_toolbar_custom ##### -->
<para>

</para>

@app: 
@uiinfo: 
@uibdata: 


<!-- ##### FUNCTION gnome_app_find_menu_pos ##### -->
<para>

</para>

@parent: 
@path: 
@pos: 
@Returns: 


<!-- ##### FUNCTION gnome_app_remove_menus ##### -->
<para>

</para>

@app: 
@path: 
@items: 


<!-- ##### FUNCTION gnome_app_remove_menu_range ##### -->
<para>

</para>

@app: 
@path: 
@start: 
@items: 


<!-- ##### FUNCTION gnome_app_insert_menus_custom ##### -->
<para>

</para>

@app: 
@path: 
@uiinfo: 
@uibdata: 


<!-- ##### FUNCTION gnome_app_insert_menus ##### -->
<para>

</para>

@app: 
@path: 
@menuinfo: 


<!-- ##### FUNCTION gnome_app_insert_menus_with_data ##### -->
<para>

</para>

@app: 
@path: 
@menuinfo: 
@data: 


<!-- ##### FUNCTION gnome_app_insert_menus_interp ##### -->
<para>

</para>

@app: 
@path: 
@menuinfo: 
@relay_func: 
@data: 
@destroy_func: 


<!-- ##### FUNCTION gnome_app_install_appbar_menu_hints ##### -->
<para>

</para>

@appbar: 
@uiinfo: 


<!-- ##### FUNCTION gnome_app_install_statusbar_menu_hints ##### -->
<para>

</para>

@bar: 
@uiinfo: 


<!-- ##### FUNCTION gnome_app_install_menu_hints ##### -->
<para>

</para>

@app: 
@uiinfo: 


<!-- ##### FUNCTION gnome_app_setup_toolbar ##### -->
<para>

</para>

@toolbar: 
@dock_item: 


<!-- ##### MACRO GNOMEUIINFO_END ##### -->
<para>
A macro that can be used to terminate an arrau of #GnomeUIInfo structures.
</para>

@Returns: A #GnomeUIInfo structure.


<!-- ##### MACRO GNOMEUIINFO_SEPARATOR ##### -->
<para>
A macro that defines a menu seperator bar. Can be put into an array of
#GnomeUIInfo structures.
</para>

@Returns: A #GnomeUIInfo structure.


<!-- ##### MACRO GNOMEUIINFO_ITEM ##### -->
<para>
A generic menu item with an inline xpm icon.
</para>

@label: Menu label.
@tooltip: Tooltip for the label.
@callback: Function to call on selection of this item.
@xpm_data: Pixmap data.
@Returns: A #GnomeUIInfo structure.


<!-- ##### MACRO GNOMEUIINFO_ITEM_STOCK ##### -->
<para>
A menu item with a stock icon.
</para>

@label: Menu label.
@tooltip: Tooltip for the label.
@callback: Function to call on selection of this item.
@stock_id: The value of stock icon (from the gnome-stock-item module of this
library).
@Returns: A #GnomeUIInfo structure.


<!-- ##### MACRO GNOMEUIINFO_ITEM_NONE ##### -->
<para>
A menu item with no icon.
</para>

@label: Menu label.
@tooltip: Tooltip for the label.
@callback: Function to call on selection of this item.
@Returns: A #GnomeUIInfo structure.


<!-- ##### MACRO GNOMEUIINFO_ITEM_DATA ##### -->
<para>
A menu item with an inline xpm icon and user data pointer for @callback.
</para>

@label: Menu label.
@tooltip: Tooltip for the label.
@callback: Function to call on selection of this item.
@user_data: User data to pass to the callback function.
@xpm_data: Pixmap data.
@Returns: A #GnomeUIInfo structure.


<!-- ##### MACRO GNOMEUIINFO_TOGGLEITEM ##### -->
<para>
A toggle item (check box) with inline xpm icon.
</para>

@label: Menu label.
@tooltip: Tooltip for the label.
@callback: Function to call on selection of this item.
@xpm_data: Pixmap data.
@Returns: A #GnomeUIInfo structure.


<!-- ##### MACRO GNOMEUIINFO_TOGGLEITEM_DATA ##### -->
<para>
A toggle item (chekc box) with inline xpm icon and user data pointer for
@callback.
</para>

@label: Menu label.
@tooltip: Tooltip for the label.
@callback: Function to call on selection of this item.
@user_data: User data to pass to the callback function.
@xpm_data: Pixmap data.
@Returns: A #GnomeUIInfo structure.


<!-- ##### MACRO GNOMEUIINFO_HELP ##### -->
<para>
A menu containing all help topics based on @app_name.
</para>

@app_name: Application id string.
@Returns: A #GnomeUIInfo structure.


<!-- ##### MACRO GNOMEUIINFO_SUBTREE ##### -->
<para>
A subtree (submenu).
</para>

@label: Submenu label.
@tree: A pointer to an array of #GnomeUIInfo structures.
@Returns: A #GnomeUIInfo structure.


<!-- ##### MACRO GNOMEUIINFO_SUBTREE_HINT ##### -->
<para>
A subtree with a hint.
</para>

@label: Submenu label.
@hint: Hint for statusbar.
@tree: A pointer to an array of #GnomeUIInfo structures.
@Returns: A #GnomeUIInfo structure.


<!-- ##### MACRO GNOMEUIINFO_SUBTREE_STOCK ##### -->
<para>
A subtree using a stock icon.
</para>

@label: 
@tree: A pointer to an array of #GnomeUIInfo structs.
@stock_id: The value of stock icon (from the gnome-stock-item module of this
library).
@Returns: A #GnomeUIInfo structure.
<!-- # Unused Parameters # -->
@Returns: A #GnomeUIInfo structure.


<!-- ##### MACRO GNOMEUIINFO_INCLUDE ##### -->
<para>
A menu that should be included at the current point of the current menu (like
#GNOMEUIINFO_SUBTREE, but doesn't create a submenu).
</para>

@tree: A pointer to an array of #GnomeUIInfo structures.
@Returns: A #GnomeUIInfo structure.


<!-- ##### MACRO GNOMEUIINFO_RADIOLIST ##### -->
<para>
A list of radio items.
</para>

@list: Pointer to a list of #GNOMEUIINFO_RADIOITEM elements.
@Returns: A #GnomeUIInfo structure.


<!-- ##### MACRO GNOMEUIINFO_RADIOITEM ##### -->
<para>
A radio item with an inline xpm icon.
</para>

@label: Item label.
@tooltip: Tooltip for the item.
@callback: Function to call on selection of this item.
@xpm_data: Pixmap data.
@Returns: A #GnomeUIInfo structure.


<!-- ##### MACRO GNOMEUIINFO_RADIOITEM_DATA ##### -->
<para>
A radio item with an inline xpm icon and user data for @callback.
</para>

@label: Item label.
@tooltip: Tooltip for the item.
@callback: Function to call on selection of this item.
@user_data: User data for the callback function.
@xpm_data: Pixmap data.
@Returns: A #GnomeUIInfo structure.


<!-- ##### MACRO GNOMEUIINFO_MENU_NEW_ITEM ##### -->
<para>
A "New" entry (typically in the "File" menu).
</para>

@label: The label for the menu item (the thing being created).
@tip: Tooltip for the item.
@cb: Callback for when the menu item is selected.
@data: User data to pass to the callback.
@Returns: A #GnomeUIInfo structure.


<!-- ##### MACRO GNOMEUIINFO_MENU_NEW_SUBTREE ##### -->
<para>
A "New" menu item that creates a subtree (for when you have more than one thing
that can be created anew).
</para>

@tree: Pointer to a list of #GnomeUIInfo menu structures.
@Returns: A #GnomeUIInfo structure.


<!-- ##### MACRO GNOMEUIINFO_MENU_OPEN_ITEM ##### -->
<para>
An "Open..." menu item.
</para>

@cb: Callback for when the menu item is selected.
@data: Used data to pass to the callback.
@Returns: A #GnomeUIInfo structure.


<!-- ##### MACRO GNOMEUIINFO_MENU_SAVE_ITEM ##### -->
<para>
A "Save" menu item.
</para>

@cb: Callback for when the menu item is selected.
@data: Used data to pass to the callback.
@Returns: A #GnomeUIInfo structure.


<!-- ##### MACRO GNOMEUIINFO_MENU_SAVE_AS_ITEM ##### -->
<para>
A "Save as..." menu item.
</para>

@cb: Callback for when the menu item is selected.
@data: Used data to pass to the callback.
@Returns: A #GnomeUIInfo structure.


<!-- ##### MACRO GNOMEUIINFO_MENU_REVERT_ITEM ##### -->
<para>
A "Revert" (to last saved) menu item.
</para>

@cb: Callback for when the menu item is selected.
@data: Used data to pass to the callback.
@Returns: A #GnomeUIInfo structure.


<!-- ##### MACRO GNOMEUIINFO_MENU_PRINT_ITEM ##### -->
<para>
A "Print" menu item.
</para>

@cb: Callback for when the menu item is selected.
@data: Used data to pass to the callback.
@Returns: A #GnomeUIInfo structure.


<!-- ##### MACRO GNOMEUIINFO_MENU_PRINT_SETUP_ITEM ##### -->
<para>
A "Print setup..." menu item.
</para>

@cb: Callback for when the menu item is selected.
@data: Used data to pass to the callback.
@Returns: A #GnomeUIInfo structure.


<!-- ##### MACRO GNOMEUIINFO_MENU_CLOSE_ITEM ##### -->
<para>
A "Close" menu item.
</para>

@cb: Callback for when the menu item is selected.
@data: Used data to pass to the callback.
@Returns: A #GnomeUIInfo structure.


<!-- ##### MACRO GNOMEUIINFO_MENU_EXIT_ITEM ##### -->
<para>
An "Exit" menu item (deprecated).
</para>

@cb: Callback for when the menu item is selected.
@data: Used data to pass to the callback.
@Returns: A #GnomeUIInfo structure.


<!-- ##### MACRO GNOMEUIINFO_MENU_QUIT_ITEM ##### -->
<para>
A "Quit" menu item.
</para>

@cb: Callback for when the menu item is selected.
@data: Used data to pass to the callback.
@Returns: A #GnomeUIInfo structure.


<!-- ##### MACRO GNOMEUIINFO_MENU_CUT_ITEM ##### -->
<para>
A "Cut" menu item.
</para>

@cb: Callback for when the menu item is selected.
@data: Used data to pass to the callback.
@Returns: A #GnomeUIInfo structure.


<!-- ##### MACRO GNOMEUIINFO_MENU_COPY_ITEM ##### -->
<para>
A "Copy" menu item.
</para>

@cb: Callback for when the menu item is selected.
@data: Used data to pass to the callback.
@Returns: A #GnomeUIInfo structure.


<!-- ##### MACRO GNOMEUIINFO_MENU_PASTE_ITEM ##### -->
<para>
A "Paste" menu item.
</para>

@cb: Callback for when the menu item is selected.
@data: Used data to pass to the callback.
@Returns: A #GnomeUIInfo structure.


<!-- ##### MACRO GNOMEUIINFO_MENU_SELECT_ALL_ITEM ##### -->
<para>
A "Select All" menu item.
</para>

@cb: Callback for when the menu item is selected.
@data: Used data to pass to the callback.
@Returns: A #GnomeUIInfo structure.


<!-- ##### MACRO GNOMEUIINFO_MENU_CLEAR_ITEM ##### -->
<para>
A "clear" menu item.
</para>

@cb: Callback for when the menu item is selected.
@data: Used data to pass to the callback.
@Returns: A #GnomeUIInfo structure.


<!-- ##### MACRO GNOMEUIINFO_MENU_UNDO_ITEM ##### -->
<para>
An "Undo" menu item.
</para>

@cb: Callback for when the menu item is selected.
@data: Used data to pass to the callback.
@Returns: A #GnomeUIInfo structure.


<!-- ##### MACRO GNOMEUIINFO_MENU_REDO_ITEM ##### -->
<para>
A "Redo" menu item.
</para>

@cb: Callback for when the menu item is selected.
@data: Used data to pass to the callback.
@Returns: A #GnomeUIInfo structure.


<!-- ##### MACRO GNOMEUIINFO_MENU_FIND_ITEM ##### -->
<para>
A "Find" menu item.
</para>

@cb: Callback for when the menu item is selected.
@data: Used data to pass to the callback.
@Returns: A #GnomeUIInfo structure.


<!-- ##### MACRO GNOMEUIINFO_MENU_FIND_AGAIN_ITEM ##### -->
<para>
A "Find Again" menu item.
</para>

@cb: Callback for when the menu item is selected.
@data: Used data to pass to the callback.
@Returns: A #GnomeUIInfo structure.


<!-- ##### MACRO GNOMEUIINFO_MENU_REPLACE_ITEM ##### -->
<para>
A "Replace" menu item.
</para>

@cb: Callback for when the menu item is selected.
@data: Used data to pass to the callback.
@Returns: A #GnomeUIInfo structure.


<!-- ##### MACRO GNOMEUIINFO_MENU_PROPERTIES_ITEM ##### -->
<para>
A "Properties..." menu item.
</para>

@cb: Callback for when the menu item is selected.
@data: Used data to pass to the callback.
@Returns: A #GnomeUIInfo structure.


<!-- ##### MACRO GNOMEUIINFO_MENU_PREFERENCES_ITEM ##### -->
<para>
A "Preferences..." menu item.
</para>

@cb: Callback for when the menu item is selected.
@data: Used data to pass to the callback.
@Returns: A #GnomeUIInfo structure.


<!-- ##### MACRO GNOMEUIINFO_MENU_NEW_WINDOW_ITEM ##### -->
<para>
A "New Window" menu item.
</para>

@cb: Callback for when the menu item is selected.
@data: Used data to pass to the callback.
@Returns: A #GnomeUIInfo structure.


<!-- ##### MACRO GNOMEUIINFO_MENU_CLOSE_WINDOW_ITEM ##### -->
<para>
A "Close Window" menu item.
</para>

@cb: Callback for when the menu item is selected.
@data: Used data to pass to the callback.
@Returns: A #GnomeUIInfo structure.


<!-- ##### MACRO GNOMEUIINFO_MENU_ABOUT_ITEM ##### -->
<para>
An "About..." menu item.
</para>

@cb: Callback for when the menu item is selected.
@data: Used data to pass to the callback.
@Returns: A #GnomeUIInfo structure.


<!-- ##### MACRO GNOMEUIINFO_MENU_NEW_GAME_ITEM ##### -->
<para>
A "New Game" menu item.
</para>

@cb: Callback for when the menu item is selected.
@data: Used data to pass to the callback.
@Returns: A #GnomeUIInfo structure.


<!-- ##### MACRO GNOMEUIINFO_MENU_PAUSE_GAME_ITEM ##### -->
<para>
A "Pause Game" menu item.
</para>

@cb: Callback for when the menu item is selected.
@data: Used data to pass to the callback.
@Returns: A #GnomeUIInfo structure.


<!-- ##### MACRO GNOMEUIINFO_MENU_RESTART_GAME_ITEM ##### -->
<para>
A "Restart Game" menu item.
</para>

@cb: Callback for when the menu item is selected.
@data: Used data to pass to the callback.
@Returns: A #GnomeUIInfo structure.


<!-- ##### MACRO GNOMEUIINFO_MENU_UNDO_MOVE_ITEM ##### -->
<para>
An "Undo Move" menu item (for games, usually).
</para>

@cb: Callback for when the menu item is selected.
@data: Used data to pass to the callback.
@Returns: A #GnomeUIInfo structure.


<!-- ##### MACRO GNOMEUIINFO_MENU_REDO_MOVE_ITEM ##### -->
<para>
A "Redo move" menu item.
</para>

@cb: Callback for when the menu item is selected.
@data: Used data to pass to the callback.
@Returns: A #GnomeUIInfo structure.


<!-- ##### MACRO GNOMEUIINFO_MENU_HINT_ITEM ##### -->
<para>
A "Hint" menu item.
</para>

@cb: Callback for when the menu item is selected.
@data: Used data to pass to the callback.
@Returns: A #GnomeUIInfo structure.


<!-- ##### MACRO GNOMEUIINFO_MENU_SCORES_ITEM ##### -->
<para>
A "Scores" menu item.
</para>

@cb: Callback for when the menu item is selected.
@data: Used data to pass to the callback.
@Returns: A #GnomeUIInfo structure.


<!-- ##### MACRO GNOMEUIINFO_MENU_END_GAME_ITEM ##### -->
<para>
An "End Game" menu item.
</para>

@cb: Callback for when the menu item is selected.
@data: Used data to pass to the callback.
@Returns: A #GnomeUIInfo structure.


<!-- ##### MACRO GNOMEUIINFO_MENU_FILE_TREE ##### -->
<para>
A "File" menu tree.
</para>

@tree: Pointer to a tree containing menu items for inside this menu.
@Returns: A #GnomeUIInfo structure.


<!-- ##### MACRO GNOMEUIINFO_MENU_EDIT_TREE ##### -->
<para>
An "Edit" menu tree.
</para>

@tree: Pointer to a tree containing menu items for inside this menu.
@Returns: A #GnomeUIInfo structure.


<!-- ##### MACRO GNOMEUIINFO_MENU_VIEW_TREE ##### -->
<para>
A "View" menu tree.
</para>

@tree: Pointer to a tree containing menu items for inside this menu.
@Returns: A #GnomeUIInfo structure.


<!-- ##### MACRO GNOMEUIINFO_MENU_SETTINGS_TREE ##### -->
<para>
A "Settings" menu tree.
</para>

@tree: Pointer to a tree containing menu items for inside this menu.
@Returns: A #GnomeUIInfo structure.


<!-- ##### MACRO GNOMEUIINFO_MENU_FILES_TREE ##### -->
<para>
A "Files" menu tree.
</para>

@tree: Pointer to a tree containing menu items for inside this menu.
@Returns: A #GnomeUIInfo structure.


<!-- ##### MACRO GNOMEUIINFO_MENU_WINDOWS_TREE ##### -->
<para>
A "Windows" menu tree.
</para>

@tree: Pointer to a tree containing menu items for inside this menu.
@Returns: A #GnomeUIInfo structure.


<!-- ##### MACRO GNOMEUIINFO_MENU_HELP_TREE ##### -->
<para>
A "Help" menu tree.
</para>

@tree: Pointer to a tree containing menu items for inside this menu.
@Returns: A #GnomeUIInfo structure.


<!-- ##### MACRO GNOMEUIINFO_MENU_GAME_TREE ##### -->
<para>
A "Game" menu tree.
</para>

@tree: Pointer to a tree containing menu items for inside this menu.
@Returns: A #GnomeUIInfo structure.


<!-- ##### MACRO GNOME_MENU_FILE_STRING ##### -->
<para>
A string which is the title of the "File" menu (when the menu is created using
#GNOMEUIINFO_MENU_FILE_TREE).
</para>

@Returns: A #GnomeUIInfo structure.


<!-- ##### MACRO GNOME_MENU_FILE_PATH ##### -->
<para>
A pre-defined path to the "File" menu (when the menu is created using
#GNOMEUIINFO_MENU_FILE_TREE). Used in calls like gnome_app_find_menu_pos().
</para>

@Returns: A #GnomeUIInfo structure.


<!-- ##### MACRO GNOME_MENU_EDIT_STRING ##### -->
<para>
A string which is the title of the "Edit" menu (when the menu is created using
#GNOMEUIINFO_MENU_FILE_TREE).
</para>

@Returns: A #GnomeUIInfo structure.


<!-- ##### MACRO GNOME_MENU_EDIT_PATH ##### -->
<para>
A pre-defined path to the "Edit" menu (when the menu is created using
#GNOMEUIINFO_MENU_EDIT_TREE). Used in calls like gnome_app_find_menu_pos().
</para>

@Returns: A #GnomeUIInfo structure.


<!-- ##### MACRO GNOME_MENU_VIEW_STRING ##### -->
<para>
A string which is the title of the "View" menu (when the menu is created using
#GNOMEUIINFO_MENU_VIEW_TREE).
</para>

@Returns: A #GnomeUIInfo structure.


<!-- ##### MACRO GNOME_MENU_VIEW_PATH ##### -->
<para>
A pre-defined path to the "View" menu (when the menu is created using
#GNOMEUIINFO_MENU_FILE_TREE). Used in calls like gnome_app_find_menu_pos().
</para>

@Returns: A #GnomeUIInfo structure.


<!-- ##### MACRO GNOME_MENU_SETTINGS_STRING ##### -->
<para>
A string which is the title of the "Settings" menu (when the menu is created
using #GNOMEUIINFO_MENU_SETTINGS_TREE).
</para>

@Returns: A #GnomeUIInfo structure.


<!-- ##### MACRO GNOME_MENU_SETTINGS_PATH ##### -->
<para>
A pre-defined path to the "Settings" menu (when the menu is created using
#GNOMEUIINFO_MENU_FILE_TREE). Used in calls like gnome_app_find_menu_pos().
</para>

@Returns: A #GnomeUIInfo structure.


<!-- ##### MACRO GNOME_MENU_NEW_STRING ##### -->
<para>
A string which is the title of the "New" menu (when the menu is created using
#GNOMEUIINFO_MENU_NEW_TREE).
</para>

@Returns: A #GnomeUIInfo structure.


<!-- ##### MACRO GNOME_MENU_NEW_PATH ##### -->
<para>
A pre-defined path to the "New" menu (when the menu is created using
#GNOMEUIINFO_MENU_FILE_TREE). Used in calls like gnome_app_find_menu_pos().
</para>

@Returns: A #GnomeUIInfo structure.


<!-- ##### MACRO GNOME_MENU_FILES_STRING ##### -->
<para>
A string which is the title of the "Files" menu (when the menu is created using
#GNOMEUIINFO_MENU_FILES_TREE).
</para>

@Returns: A #GnomeUIInfo structure.


<!-- ##### MACRO GNOME_MENU_FILES_PATH ##### -->
<para>
A pre-defined path to the "Files" menu (when the menu is created using
#GNOMEUIINFO_MENU_FILE_TREE). Used in calls like gnome_app_find_menu_pos().
</para>

@Returns: A #GnomeUIInfo structure.


<!-- ##### MACRO GNOME_MENU_WINDOWS_STRING ##### -->
<para>
A string which is the title of the "Windows" menu (when the menu is created
using #GNOMEUIINFO_MENU_WINDOWS_TREE).
</para>

@Returns: A #GnomeUIInfo structure.


<!-- ##### MACRO GNOME_MENU_WINDOWS_PATH ##### -->
<para>
A pre-defined path to the "Windows" menu (when the menu is created using
#GNOMEUIINFO_MENU_FILE_TREE). Used in calls like gnome_app_find_menu_pos().
</para>

@Returns: A #GnomeUIInfo structure.


<!-- ##### FUNCTION gnome_app_helper_gettext ##### -->
<para>
Translate @string by calling gettext() and then, if that did not change the
string, dgettext() with the domain set to libgnome's message domain.
</para>

@string: The string to translate.
@Returns: The localised value of the string.


<!-- ##### MACRO L_ ##### -->
<para>
Syntactic sugar for gnome_app_helper_gettext().
</para>

@x: 


<!-- ##### MACRO D_ ##### -->
<para>
Syntactic sugar for calling dgettext() with the domain set to libgnome's message
domain.
</para>

@x: 


