 -- Class: <gtk-menu-item>
     Derives from <gtk-item>.

     This class defines the following slots:

     submenu
          The submenu attached to the menu item, or NULL if it has none

 -- Signal on <gtk-menu-item>: activate
     Emitted when the item is activated.

 -- Signal on <gtk-menu-item>: activate-item
     Emitted when the item is activated, but also if the menu item has a submenu. For normal applications, the relevant signal is "activate".

 -- Signal on <gtk-menu-item>: toggle-size-request (arg0 <gpointer>)

 -- Signal on <gtk-menu-item>: toggle-size-allocate (arg0 <gint>)

 -- Function: gtk-menu-item-new =>  (ret <gtk-widget>)
     Creates a new <gtk-menu-item>.

     ret
          the newly created <gtk-menu-item>

 -- Function: gtk-menu-item-new-with-label (label mchars) =>  (ret <gtk-widget>)
     Creates a new <gtk-menu-item> whose child is a <gtk-label>.

     label
          the text for the label

     ret
          the newly created <gtk-menu-item>

 -- Function: gtk-menu-item-new-with-mnemonic (label mchars) =>  (ret <gtk-widget>)
     Creates a new <gtk-menu-item> containing a label. The label will be created using gtk-label-new-with-mnemonic, so underscores in LABEL indicate the mnemonic for the menu item.

     label
          The text of the button, with an underscore in front of the mnemonic character

     ret
          a new <gtk-menu-item>

 -- Function: gtk-menu-item-set-right-justified (self <gtk-menu-item>) (right_justified bool)
 -- Method: set-right-justified
     Sets whether the menu item appears justified at the right side of a menu bar. This was traditionally done for "Help" menu items, but is now considered a bad idea. (If the widget layout is reversed for a right-to-left language like Hebrew or Arabic, right-justified-menu-items appear at the left.)

     menu-item
          a <gtk-menu-item>.

     right-justified
          if #t the menu item will appear at the far right if added to a menu bar.

 -- Function: gtk-menu-item-set-submenu (self <gtk-menu-item>) (submenu <gtk-widget>)
 -- Method: set-submenu
     Sets the widget submenu, or changes it.

     menu-item
          the menu item widget

     submenu
          the submenu

 -- Function: gtk-menu-item-set-accel-path (self <gtk-menu-item>) (accel_path mchars)
 -- Method: set-accel-path
     Set the accelerator path on MENU-ITEM, through which runtime changes of the menu item's accelerator caused by the user can be identified and saved to persistant storage (see gtk-accel-map-save on this). To setup a default accelerator for this menu item, call gtk-accel-map-add-entry with the same ACCEL-PATH. See also gtk-accel-map-add-entry on the specifics of accelerator paths, and gtk-menu-set-accel-path for a more convenient variant of this function.

     This function is basically a convenience wrapper that handles calling gtk-widget-set-accel-path with the appropriate accelerator group for the menu item.

     Note that you do need to set an accelerator on the parent menu with gtk-menu-set-accel-group for this to work.

     menu-item
          a valid <gtk-menu-item>

     accel-path
          accelerator path, corresponding to this menu item's functionality, or #f to unset the current path.

 -- Function: gtk-menu-item-remove-submenu (self <gtk-menu-item>)
 -- Method: remove-submenu
     Removes the widget's submenu.

     menu-item
          the menu item widget

 -- Function: gtk-menu-item-select (self <gtk-menu-item>)
 -- Method: select
     Emits the "select" signal on the given item. Behaves exactly like <gtk-item-select>.

     menu-item
          the menu item

 -- Function: gtk-menu-item-deselect (self <gtk-menu-item>)
 -- Method: deselect
     Emits the "deselect" signal on the given item. Behaves exactly like <gtk-item-deselect>.

     menu-item
          the menu item

 -- Function: gtk-menu-item-activate (self <gtk-menu-item>)
 -- Method: activate
     Emits the "activate" signal on the given item

     menu-item
          the menu item

 -- Function: gtk-menu-item-toggle-size-request (self <gtk-menu-item>) =>  (requisition int)
 -- Method: toggle-size-request
     Emits the "toggle_size_request" signal on the given item.

     menu-item
          the menu item

     requisition
          the requisition to use as signal data.

 -- Function: gtk-menu-item-toggle-size-allocate (self <gtk-menu-item>) (allocation int)
 -- Method: toggle-size-allocate
     Emits the "toggle_size_allocate" signal on the given item.

     menu-item
          the menu item.

     allocation
          the allocation to use as signal data.

 -- Function: gtk-menu-item-get-right-justified (self <gtk-menu-item>) =>  (ret bool)
 -- Method: get-right-justified
     Gets whether the menu item appears justified at the right side of the menu bar.

     menu-item
          a <gtk-menu-item>

     ret
          #t if the menu item will appear at the far right if added to a menu bar.

 -- Function: gtk-menu-item-get-submenu (self <gtk-menu-item>) =>  (ret <gtk-widget>)
 -- Method: get-submenu
     Gets the submenu underneath this menu item, if any. See gtk-menu-item-set-submenu.

     menu-item
          a <gtk-menu-item>

     ret
          submenu for this menu item, or #f if none.