* New upstream release.

  * Add a signal on the menuitem for generic event support
  * Handle the case of a single NULL entry as well.
  * Not checking defaults when value is NULL
  * Add the 'type' variable first when processing new
    menuitems
  * Protection from unref'ing NULL variants
  * Only send the requested properties and request fewer
  * Add in a defaults database
  * Only send property updates if the menu item has been
    seen on the bus.
  * Add a property for text direction.
  * Add a property for needing attention.
  * Documentation fixes
  * Making menuitems track their own parents
  * Resolving property changes by looking at the properties
    directly.

1 files changed, 635 insertions, 0 deletions

diff --git a/docs/libdbusmenu-glib/reference/tmpl/menuitem.sgml b/docs/libdbusmenu-glib/reference/tmpl/menuitem.sgml
new file mode 100644
index 0000000..c45f2c9
--- /dev/null
+++ b/docs/libdbusmenu-glib/reference/tmpl/menuitem.sgml
@@ -0,0 +1,635 @@
+<!-- ##### SECTION Title ##### -->
+DbusmenuMenuitem
+
+<!-- ##### SECTION Short_Description ##### -->
+
+
+<!-- ##### SECTION Long_Description ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION See_Also ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION Stability_Level ##### -->
+
+
+<!-- ##### SECTION Image ##### -->
+
+
+<!-- ##### MACRO DBUSMENU_MENUITEM_SIGNAL_PROPERTY_CHANGED ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO DBUSMENU_MENUITEM_SIGNAL_ITEM_ACTIVATED ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO DBUSMENU_MENUITEM_SIGNAL_CHILD_ADDED ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO DBUSMENU_MENUITEM_SIGNAL_CHILD_REMOVED ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO DBUSMENU_MENUITEM_SIGNAL_CHILD_MOVED ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO DBUSMENU_MENUITEM_SIGNAL_EVENT ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO DBUSMENU_MENUITEM_SIGNAL_REALIZED ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO DBUSMENU_MENUITEM_SIGNAL_REALIZED_ID ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO DBUSMENU_MENUITEM_SIGNAL_ABOUT_TO_SHOW ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO DBUSMENU_MENUITEM_SIGNAL_SHOW_TO_USER ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO DBUSMENU_MENUITEM_PROP_TYPE ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO DBUSMENU_MENUITEM_PROP_VISIBLE ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO DBUSMENU_MENUITEM_PROP_ENABLED ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO DBUSMENU_MENUITEM_PROP_LABEL ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO DBUSMENU_MENUITEM_PROP_ICON_NAME ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO DBUSMENU_MENUITEM_PROP_ICON_DATA ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO DBUSMENU_MENUITEM_PROP_TOGGLE_TYPE ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO DBUSMENU_MENUITEM_PROP_TOGGLE_STATE ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO DBUSMENU_MENUITEM_PROP_CHILD_DISPLAY ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO DBUSMENU_MENUITEM_PROP_SHORTCUT ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO DBUSMENU_MENUITEM_TOGGLE_CHECK ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO DBUSMENU_MENUITEM_TOGGLE_RADIO ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO DBUSMENU_MENUITEM_TOGGLE_STATE_UNCHECKED ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO DBUSMENU_MENUITEM_TOGGLE_STATE_CHECKED ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO DBUSMENU_MENUITEM_TOGGLE_STATE_UNKNOWN ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO DBUSMENU_MENUITEM_ICON_NAME_BLANK ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO DBUSMENU_MENUITEM_CHILD_DISPLAY_SUBMENU ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO DBUSMENU_MENUITEM_SHORTCUT_ALT ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO DBUSMENU_MENUITEM_SHORTCUT_CONTROL ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO DBUSMENU_MENUITEM_SHORTCUT_SHIFT ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO DBUSMENU_MENUITEM_SHORTCUT_SUPER ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### STRUCT DbusmenuMenuitem ##### -->
+<para>
+
+</para>
+
+@parent: 
+@priv: 
+
+<!-- ##### USER_FUNCTION dbusmenu_menuitem_about_to_show_cb ##### -->
+<para>
+
+</para>
+
+@mi: 
+@user_data: 
+
+
+<!-- ##### USER_FUNCTION dbusmenu_menuitem_buildvariant_slot_t ##### -->
+<para>
+
+</para>
+
+@mi: 
+@properties: 
+@Returns: 
+
+
+<!-- ##### STRUCT DbusmenuMenuitemClass ##### -->
+<para>
+
+</para>
+
+@parent_class: 
+@property_changed: 
+@item_activated: 
+@child_added: 
+@child_removed: 
+@child_moved: 
+@realized: 
+@buildvariant: 
+@handle_event: 
+@show_to_user: 
+@about_to_show: 
+@event: 
+@reserved1: 
+@reserved2: 
+@reserved3: 
+@reserved4: 
+@reserved5: 
+
+<!-- ##### FUNCTION dbusmenu_menuitem_new ##### -->
+<para>
+
+</para>
+
+@void: 
+@Returns: 
+
+
+<!-- ##### FUNCTION dbusmenu_menuitem_new_with_id ##### -->
+<para>
+
+</para>
+
+@id: 
+@Returns: 
+
+
+<!-- ##### FUNCTION dbusmenu_menuitem_get_id ##### -->
+<para>
+
+</para>
+
+@mi: 
+@Returns: 
+
+
+<!-- ##### FUNCTION dbusmenu_menuitem_get_children ##### -->
+<para>
+
+</para>
+
+@mi: 
+@Returns: 
+
+
+<!-- ##### FUNCTION dbusmenu_menuitem_take_children ##### -->
+<para>
+
+</para>
+
+@mi: 
+@Returns: 
+
+
+<!-- ##### FUNCTION dbusmenu_menuitem_get_position ##### -->
+<para>
+
+</para>
+
+@mi: 
+@parent: 
+@Returns: 
+
+
+<!-- ##### FUNCTION dbusmenu_menuitem_get_position_realized ##### -->
+<para>
+
+</para>
+
+@mi: 
+@parent: 
+@Returns: 
+
+
+<!-- ##### FUNCTION dbusmenu_menuitem_child_append ##### -->
+<para>
+
+</para>
+
+@mi: 
+@child: 
+@Returns: 
+
+
+<!-- ##### FUNCTION dbusmenu_menuitem_child_prepend ##### -->
+<para>
+
+</para>
+
+@mi: 
+@child: 
+@Returns: 
+
+
+<!-- ##### FUNCTION dbusmenu_menuitem_child_delete ##### -->
+<para>
+
+</para>
+
+@mi: 
+@child: 
+@Returns: 
+
+
+<!-- ##### FUNCTION dbusmenu_menuitem_child_add_position ##### -->
+<para>
+
+</para>
+
+@mi: 
+@child: 
+@position: 
+@Returns: 
+
+
+<!-- ##### FUNCTION dbusmenu_menuitem_child_reorder ##### -->
+<para>
+
+</para>
+
+@mi: 
+@child: 
+@position: 
+@Returns: 
+
+
+<!-- ##### FUNCTION dbusmenu_menuitem_child_find ##### -->
+<para>
+
+</para>
+
+@mi: 
+@id: 
+@Returns: 
+
+
+<!-- ##### FUNCTION dbusmenu_menuitem_find_id ##### -->
+<para>
+
+</para>
+
+@mi: 
+@id: 
+@Returns: 
+
+
+<!-- ##### FUNCTION dbusmenu_menuitem_property_set ##### -->
+<para>
+
+</para>
+
+@mi: 
+@property: 
+@value: 
+@Returns: 
+
+
+<!-- ##### FUNCTION dbusmenu_menuitem_property_set_bool ##### -->
+<para>
+
+</para>
+
+@mi: 
+@property: 
+@value: 
+@Returns: 
+
+
+<!-- ##### FUNCTION dbusmenu_menuitem_property_set_int ##### -->
+<para>
+
+</para>
+
+@mi: 
+@property: 
+@value: 
+@Returns: 
+
+
+<!-- ##### FUNCTION dbusmenu_menuitem_property_set_variant ##### -->
+<para>
+
+</para>
+
+@mi: 
+@property: 
+@value: 
+@Returns: 
+
+
+<!-- ##### FUNCTION dbusmenu_menuitem_property_get ##### -->
+<para>
+
+</para>
+
+@mi: 
+@property: 
+@Returns: 
+
+
+<!-- ##### FUNCTION dbusmenu_menuitem_property_get_bool ##### -->
+<para>
+
+</para>
+
+@mi: 
+@property: 
+@Returns: 
+
+
+<!-- ##### FUNCTION dbusmenu_menuitem_property_get_int ##### -->
+<para>
+
+</para>
+
+@mi: 
+@property: 
+@Returns: 
+
+
+<!-- ##### FUNCTION dbusmenu_menuitem_property_get_variant ##### -->
+<para>
+
+</para>
+
+@mi: 
+@property: 
+@Returns: 
+
+
+<!-- ##### FUNCTION dbusmenu_menuitem_property_exist ##### -->
+<para>
+
+</para>
+
+@mi: 
+@property: 
+@Returns: 
+
+
+<!-- ##### FUNCTION dbusmenu_menuitem_properties_list ##### -->
+<para>
+
+</para>
+
+@mi: 
+@Returns: 
+
+
+<!-- ##### FUNCTION dbusmenu_menuitem_properties_copy ##### -->
+<para>
+
+</para>
+
+@mi: 
+@Returns: 
+
+
+<!-- ##### FUNCTION dbusmenu_menuitem_property_remove ##### -->
+<para>
+
+</para>
+
+@mi: 
+@property: 
+
+
+<!-- ##### FUNCTION dbusmenu_menuitem_set_root ##### -->
+<para>
+
+</para>
+
+@mi: 
+@root: 
+
+
+<!-- ##### FUNCTION dbusmenu_menuitem_get_root ##### -->
+<para>
+
+</para>
+
+@mi: 
+@Returns: 
+
+
+<!-- ##### FUNCTION dbusmenu_menuitem_foreach ##### -->
+<para>
+
+</para>
+
+@mi: 
+@func: 
+@data: 
+
+
+<!-- ##### FUNCTION dbusmenu_menuitem_handle_event ##### -->
+<para>
+
+</para>
+
+@mi: 
+@name: 
+@variant: 
+@timestamp: 
+
+
+<!-- ##### FUNCTION dbusmenu_menuitem_send_about_to_show ##### -->
+<para>
+
+</para>
+
+@mi: 
+@cb: 
+@cb_data: 
+
+
+<!-- ##### FUNCTION dbusmenu_menuitem_show_to_user ##### -->
+<para>
+
+</para>
+
+@mi: 
+@timestamp: 
+
+
+<!-- ##### FUNCTION dbusmenu_menuitem_get_parent ##### -->
+<para>
+
+</para>
+
+@mi: 
+@Returns: 
+
+
+<!-- ##### FUNCTION dbusmenu_menuitem_set_parent ##### -->
+<para>
+
+</para>
+
+@mi: 
+@parent: 
+@Returns: 
+
+
+<!-- ##### FUNCTION dbusmenu_menuitem_unparent ##### -->
+<para>
+
+</para>
+
+@mi: 
+@Returns: 
+
+