From 2e8bdc835c50f84782f4c32fc4a947444848ffaf Mon Sep 17 00:00:00 2001
From: Ted Gould <ted@canonical.com>
Date: Wed, 28 Oct 2009 11:55:50 -0500
Subject: First step, change the interface name.

---
 libdbusmenu-glib/dbus-menu.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

(limited to 'libdbusmenu-glib')

diff --git a/libdbusmenu-glib/dbus-menu.xml b/libdbusmenu-glib/dbus-menu.xml
index cca9823..2a68ddd 100644
--- a/libdbusmenu-glib/dbus-menu.xml
+++ b/libdbusmenu-glib/dbus-menu.xml
@@ -28,7 +28,7 @@ License version 3 and version 2.1 along with this program.  If not, see
 <http://www.gnu.org/licenses/>
 -->
 <node name="/">
-	<interface name="org.freedesktop.dbusmenu">
+	<interface name="org.ayatana.dbusmenu">
 
 <!-- Properties -->
 		<property name="layout" type="s" access="read"/>
-- 
cgit v1.2.3


From 3615a9e9406d6bee823e323fef0e2193a9ce4e3c Mon Sep 17 00:00:00 2001
From: Ted Gould <ted@canonical.com>
Date: Wed, 28 Oct 2009 11:57:04 -0500
Subject: Changing the function calls to match the change.

---
 libdbusmenu-glib/client.c | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

(limited to 'libdbusmenu-glib')

diff --git a/libdbusmenu-glib/client.c b/libdbusmenu-glib/client.c
index ab307bd..349ae73 100644
--- a/libdbusmenu-glib/client.c
+++ b/libdbusmenu-glib/client.c
@@ -351,7 +351,7 @@ id_update (DBusGProxy * proxy, guint id, DbusmenuClient * client)
 	DbusmenuMenuitem * menuitem = dbusmenu_menuitem_find_id(priv->root, id);
 	g_return_if_fail(menuitem != NULL);
 
-	org_freedesktop_dbusmenu_get_properties_async(proxy, id, menuitem_get_properties_cb, menuitem);
+	org_ayatana_dbusmenu_get_properties_async(proxy, id, menuitem_get_properties_cb, menuitem);
 	return;
 }
 
@@ -647,7 +647,7 @@ static void
 menuitem_activate (DbusmenuMenuitem * mi, DbusmenuClient * client)
 {
 	DbusmenuClientPrivate * priv = DBUSMENU_CLIENT_GET_PRIVATE(client);
-	org_freedesktop_dbusmenu_call_async (priv->menuproxy, dbusmenu_menuitem_get_id(mi), menuitem_call_cb, mi);
+	org_ayatana_dbusmenu_call_async (priv->menuproxy, dbusmenu_menuitem_get_id(mi), menuitem_call_cb, mi);
 	return;
 }
 
@@ -689,7 +689,7 @@ parse_layout_xml(DbusmenuClient * client, xmlNodePtr node, DbusmenuMenuitem * it
 			propdata->item    = item;
 			propdata->parent  = parent;
 
-			org_freedesktop_dbusmenu_get_properties_async(proxy, id, menuitem_get_properties_new_cb, propdata);
+			org_ayatana_dbusmenu_get_properties_async(proxy, id, menuitem_get_properties_new_cb, propdata);
 		} else {
 			g_warning("Unable to allocate memory to get properties for menuitem.  This menuitem will never be realized.");
 		}
-- 
cgit v1.2.3


From 7c5ed374e35a958c50ad74e26bb6df6f8e9e0c7c Mon Sep 17 00:00:00 2001
From: Ted Gould <ted@canonical.com>
Date: Wed, 28 Oct 2009 11:58:24 -0500
Subject: Chaning the default object path.

---
 libdbusmenu-glib/server.c | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

(limited to 'libdbusmenu-glib')

diff --git a/libdbusmenu-glib/server.c b/libdbusmenu-glib/server.c
index 1ac1da6..84bfffe 100644
--- a/libdbusmenu-glib/server.c
+++ b/libdbusmenu-glib/server.c
@@ -161,7 +161,7 @@ dbusmenu_server_class_init (DbusmenuServerClass *class)
 	g_object_class_install_property (object_class, PROP_DBUS_OBJECT,
 	                                 g_param_spec_string(DBUSMENU_SERVER_PROP_DBUS_OBJECT, "DBus object path",
 	                                              "The object that represents this set of menus on DBus",
-	                                              "/org/freedesktop/dbusmenu",
+	                                              "/org/ayatana/dbusmenu",
 	                                              G_PARAM_READWRITE | G_PARAM_CONSTRUCT_ONLY | G_PARAM_STATIC_STRINGS));
 	g_object_class_install_property (object_class, PROP_ROOT_NODE,
 	                                 g_param_spec_object(DBUSMENU_SERVER_PROP_ROOT_NODE, "Root menu node",
@@ -472,7 +472,7 @@ _dbusmenu_server_call (DbusmenuServer * server, guint id, GError ** error)
 
 	Creates a new #DbusmenuServer object with a specific object
 	path on DBus.  If @object is set to NULL the default object
-	name of "/org/freedesktop/dbusmenu" will be used.
+	name of "/org/ayatana/dbusmenu" will be used.
 
 	Return value: A brand new #DbusmenuServer
 */
@@ -480,7 +480,7 @@ DbusmenuServer *
 dbusmenu_server_new (const gchar * object)
 {
 	if (object == NULL) {
-		object = "/org/freedesktop/dbusmenu";
+		object = "/org/ayatana/dbusmenu";
 	}
 
 	DbusmenuServer * self = g_object_new(DBUSMENU_TYPE_SERVER,
-- 
cgit v1.2.3


From ae17afafe8ab3282e597542195595dffbe5fed99 Mon Sep 17 00:00:00 2001
From: Ted Gould <ted@canonical.com>
Date: Wed, 28 Oct 2009 11:58:38 -0500
Subject: Changing the interface name for properties.

---
 libdbusmenu-glib/client.c | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

(limited to 'libdbusmenu-glib')

diff --git a/libdbusmenu-glib/client.c b/libdbusmenu-glib/client.c
index 349ae73..61f1ccf 100644
--- a/libdbusmenu-glib/client.c
+++ b/libdbusmenu-glib/client.c
@@ -472,7 +472,7 @@ build_proxies (DbusmenuClient * client)
 	priv->menuproxy = dbus_g_proxy_new_for_name_owner(priv->session_bus,
 	                                                  priv->dbus_name,
 	                                                  priv->dbus_object,
-	                                                  "org.freedesktop.dbusmenu",
+	                                                  "org.ayatana.dbusmenu",
 	                                                  &error);
 	if (error != NULL) {
 		g_warning("Unable to get dbusmenu proxy for %s on %s: %s", priv->dbus_name, priv->dbus_object, error->message);
@@ -829,7 +829,7 @@ update_layout (DbusmenuClient * client)
 	                                            update_layout_cb,
 	                                            client,
 	                                            NULL,
-	                                            G_TYPE_STRING, "org.freedesktop.dbusmenu",
+	                                            G_TYPE_STRING, "org.ayatana.dbusmenu",
 	                                            G_TYPE_STRING, "layout",
 	                                            G_TYPE_INVALID, G_TYPE_VALUE, G_TYPE_INVALID);
 
-- 
cgit v1.2.3


From d3d19b7180357ddd33ff77a94cbf228681f650e4 Mon Sep 17 00:00:00 2001
From: Aurelien Gateau <aurelien.gateau@canonical.com>
Date: Fri, 13 Nov 2009 14:33:30 -0600
Subject: New DBus menu API

---
 libdbusmenu-glib/dbus-menu.xml | 140 +++++++++++++++++++++++++++--------------
 1 file changed, 92 insertions(+), 48 deletions(-)

(limited to 'libdbusmenu-glib')

diff --git a/libdbusmenu-glib/dbus-menu.xml b/libdbusmenu-glib/dbus-menu.xml
index c22d477..6f5bdb2 100644
--- a/libdbusmenu-glib/dbus-menu.xml
+++ b/libdbusmenu-glib/dbus-menu.xml
@@ -30,91 +30,135 @@ License version 3 and version 2.1 along with this program.  If not, see
 <node name="/">
 	<interface name="org.freedesktop.dbusmenu">
 
-<!-- Properties -->
-<!--
-Provides an XML representation of the menu hierarchy
-
-XML syntax:
-
-<menu id="1" revision="2"> # Root container
-  <menu id="2" revision="2"> # First level menu, for example "File"
-    <menu id="3" revision="2"/> ~ Second level menu, for example "Open"
-    <menu id="4" revision="3"/>
-    ...
-  </menu>
-  <menu id="5" revision="2"> # Another first level menu, say "Edit"
-    ...
-  </menu>
-  ...
-</menu>
--->
-		<property name="layout" type="s" access="read"/>
-
 <!-- Functions -->
 
 <!--
-Each menu item has a set of properties. Property keys are in menuitem.h:
+Returns the list of items which are children of @a parentId.
 
-- visible
-- sensitive
-- label
-- icon
-- icon-data
-- type
+@param parentid unsigned the parent id for the list. If it is 0, returns the root
+item list;
+@param propertyNames list of string the list of item properties we are interested in
 
-"type" property is an enum which can take the following values (client.h):
+An item is represented as a struct following this format:
+@li id unsigned the item id
+@li properties map(string => variant) the requested item properties
 
-- menuitem
-- separator
-- imageitem
+-->
+		<method name="GetChildren">
+			<arg type="u" name="parentId" direction="in" />
+			<arg type="as" name="propertyNames" direction="in" />
+			<arg type="a(ua{sv})" name="children" direction="out" />
+		</method>
+
+<!--
+Each menu item has a set of properties. Property keys are in menuitem.h:
+
+@li type string Type of the item (see below)
+@li label string Text of the item
+@li icon-data binary Raw data of the icon (TODO: define format)
+@li icon string Icon name of the item, following icon spec
+@li sensitive boolean Whether the item can be activated or not
+@li visible boolean Whether the item is visible or not (XXX: Is this necessary?)
+@li checked boolean Whether a checkbox or radio item is checked
+@li shortcut string The keyboard shortcut
+
+@c type property is an enum which can take the following values (client.h):
+
+@li action An item which can be clicked to trigger an action
+@li checkbox An item which can be checked or unchecked
+@li radio An item which can be checked or unchecked as part of a group
+@li separator A separator
+@li menu An item which contains more items
 -->
 		<method name="GetProperty">
 			<arg type="u" name="id" direction="in" />
-			<arg type="s" name="property" direction="in" />
-			<arg type="s" name="value" direction="out" />
+			<arg type="s" name="name" direction="in" />
+			<arg type="v" name="value" direction="out" />
 		</method>
 
 <!--
-Convenience method to retrieve all properties in one call (more efficient)
+Returns multiple properties in one call. This is more efficient than
+GetProperty.
+
+@param id unsigned the item whose properties we want to retrieve.
+@param propertyNames list of string name of the properties we want.
 -->
 		<method name="GetProperties">
+			<annotation name="com.trolltech.QtDBus.QtTypeName.Out0" value="QVariantMap"/>
 			<arg type="u" name="id" direction="in" />
-			<arg type="a{ss}" name="properties" direction="out" />
+			<arg type="as" name="propertyNames" direction="in" />
+			<arg type="a{sv}" name="properties" direction="out" />
 		</method>
 
 <!--
-This is called by the display to notify the application it should trigger
-the action associated with a specific menu id
+This is called by the applet to notify the application an event happened on a
+menu item.
+
+@param id the id of the item which received the event
+@param type the type of event
+@param data event-specific data
+
+@a type can be one of the following:
+
+@li "clicked"
+@li "hovered"
+
+Vendor specific events can be added by prefixing them with "x-<vendor>-"
 -->
-		<method name="Call">
+		<method name="Event">
 			<arg type="u" name="id" direction="in" />
+			<arg type="s" name="eventId" direction="in" />
+			<arg type="v" name="data" direction="in" />
 		</method>
 
 <!-- Signals -->
 <!--
-Triggered by the application to notify display that the property prop from menu id
-as changed to value.
+Triggered by the application to notify the applet that the property @a property
+from item @a id has changed to @a value.
 -->
-		<signal name="IdPropUpdate">
+		<signal name="ItemPropertyUpdated">
 			<arg type="u" name="id" direction="out" />
 			<arg type="s" name="prop" direction="out" />
 			<arg type="s" name="value" direction="out" />
 		</signal>
 
 <!--
-Triggered by the application to notify display that all properties of menu id
-should be considered outdated
+Triggered by the application to notify the applet that all properties of item
+@a id should be considered outdated
+-->
+		<signal name="ItemUpdated">
+			<arg type="u" name="id" direction="out" />
+		</signal>
+
+<!--
+Triggered by the application to notify applet it should retrieve the children
+for item @a id.
+-->
+		<signal name="ChildrenUpdated">
+			<arg type="u" name="id" direction="out" />
+		</signal>
+
+<!--
+Triggered by the application to notify applet that an item has been added.
+
+@param id unsigned id of the added item
+@param parentid unsigned id of the added item parent. O if the item is
+added to the root list
+@param row unsigned position the item has been added
 -->
-		<signal name="IdUpdate">
+		<signal name="ItemAdded">
 			<arg type="u" name="id" direction="out" />
+			<arg type="u" name="parentId" direction="out" />
+			<arg type="u" name="row" direction="out" />
 		</signal>
 
 <!--
-Triggered by the application to notify display of a layout update, up to
-revision
+Triggered by the application to notify applet that an item has been removed.
+
+@param id unsigned id of the removed item
 -->
-		<signal name="LayoutUpdate">
-			<arg type="i" name="revision" direction="out" />
+		<signal name="ItemRemoved">
+			<arg type="u" name="id" direction="out" />
 		</signal>
 
 <!-- End of interesting stuff -->
-- 
cgit v1.2.3


From 43e54b6b9331c4b626cac1a4929a93f4fcf5af87 Mon Sep 17 00:00:00 2001
From: Aurelien Gateau <aurelien.gateau@canonical.com>
Date: Fri, 13 Nov 2009 15:20:08 -0600
Subject: Removed ItemAdded/ItemRemoved for now

---
 libdbusmenu-glib/dbus-menu.xml | 23 -----------------------
 1 file changed, 23 deletions(-)

(limited to 'libdbusmenu-glib')

diff --git a/libdbusmenu-glib/dbus-menu.xml b/libdbusmenu-glib/dbus-menu.xml
index 6f5bdb2..7433ba2 100644
--- a/libdbusmenu-glib/dbus-menu.xml
+++ b/libdbusmenu-glib/dbus-menu.xml
@@ -138,29 +138,6 @@ for item @a id.
 			<arg type="u" name="id" direction="out" />
 		</signal>
 
-<!--
-Triggered by the application to notify applet that an item has been added.
-
-@param id unsigned id of the added item
-@param parentid unsigned id of the added item parent. O if the item is
-added to the root list
-@param row unsigned position the item has been added
--->
-		<signal name="ItemAdded">
-			<arg type="u" name="id" direction="out" />
-			<arg type="u" name="parentId" direction="out" />
-			<arg type="u" name="row" direction="out" />
-		</signal>
-
-<!--
-Triggered by the application to notify applet that an item has been removed.
-
-@param id unsigned id of the removed item
--->
-		<signal name="ItemRemoved">
-			<arg type="u" name="id" direction="out" />
-		</signal>
-
 <!-- End of interesting stuff -->
 
 	</interface>
-- 
cgit v1.2.3


From 8145a3f756f116b4be480e2a75a782e5c237dd15 Mon Sep 17 00:00:00 2001
From: Aurelien Gateau <aurelien.gateau@canonical.com>
Date: Fri, 13 Nov 2009 15:24:01 -0600
Subject: Fixed type of value param in ItemPropertyUpdated() signal

---
 libdbusmenu-glib/dbus-menu.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

(limited to 'libdbusmenu-glib')

diff --git a/libdbusmenu-glib/dbus-menu.xml b/libdbusmenu-glib/dbus-menu.xml
index 7433ba2..bd2d7e5 100644
--- a/libdbusmenu-glib/dbus-menu.xml
+++ b/libdbusmenu-glib/dbus-menu.xml
@@ -119,7 +119,7 @@ from item @a id has changed to @a value.
 		<signal name="ItemPropertyUpdated">
 			<arg type="u" name="id" direction="out" />
 			<arg type="s" name="prop" direction="out" />
-			<arg type="s" name="value" direction="out" />
+			<arg type="v" name="value" direction="out" />
 		</signal>
 
 <!--
-- 
cgit v1.2.3


From 4832ff2ee2677cf76706d979c96a24965d76bcf2 Mon Sep 17 00:00:00 2001
From: Ted Gould <ted@gould.cx>
Date: Tue, 8 Dec 2009 10:53:58 -0600
Subject: Changes to keep layouts but all for globbing of properties in a
 similar way.

---
 libdbusmenu-glib/dbus-menu.xml | 65 +++++++++++++++++++++++++++++++++++-------
 1 file changed, 54 insertions(+), 11 deletions(-)

(limited to 'libdbusmenu-glib')

diff --git a/libdbusmenu-glib/dbus-menu.xml b/libdbusmenu-glib/dbus-menu.xml
index 75afcba..e2d872b 100644
--- a/libdbusmenu-glib/dbus-menu.xml
+++ b/libdbusmenu-glib/dbus-menu.xml
@@ -30,24 +30,62 @@ License version 3 and version 2.1 along with this program.  If not, see
 <node name="/">
 	<interface name="org.ayatana.dbusmenu">
 
+<!-- Properties -->
+<!--
+Provides the version of the DBusmenu API that this API is
+implementing.
+-->
+		<property name="version" type="u" access="read"/>
+
 <!-- Functions -->
 
+<!--
+Provides an XML representation of the menu hierarchy
+
+@param parentId The ID of the parent node for the layout.  For
+	grabbing the layout from the root node use zero.
+@param revision The revision number of the layout.  For matching
+	with layoutUpdated signals.
+@param layout The layout as an XML string of IDs.
+
+XML syntax:
+
+<menu id="1" revision="2"> # Root container
+  <menu id="2" revision="2"> # First level menu, for example "File"
+    <menu id="3" revision="2"/> ~ Second level menu, for example "Open"
+    <menu id="4" revision="3"/>
+    ...
+  </menu>
+  <menu id="5" revision="2"> # Another first level menu, say "Edit"
+    ...
+  </menu>
+  ...
+</menu>
+-->
+		<method name="GetLayout">
+			<arg type="u" name="parentId" direction="in" />
+			<arg type="u" name="revision" direction="out" />
+			<arg type="s" name="layout" direction="out" />
+		</method>
+
 <!--
 Returns the list of items which are children of @a parentId.
 
-@param parentid unsigned the parent id for the list. If it is 0, returns the root
-item list;
-@param propertyNames list of string the list of item properties we are interested in
+@param Ids A list of ids that we should be finding the properties
+	on.  If the list is empty, all menu items should be sent.
+@param propertyNames list of string the list of item properties we
+	are interested in.  If there are no entries in the list all of
+	the properties will be sent.
 
 An item is represented as a struct following this format:
 @li id unsigned the item id
 @li properties map(string => variant) the requested item properties
 
 -->
-		<method name="GetChildren">
-			<arg type="u" name="parentId" direction="in" />
+		<method name="GetGroupProperties">
+			<arg type="au" name="Ids" direction="in" />
 			<arg type="as" name="propertyNames" direction="in" />
-			<arg type="a(ua{sv})" name="children" direction="out" />
+			<arg type="a(ua{sv})" name="properties" direction="out" />
 		</method>
 
 <!--
@@ -81,7 +119,7 @@ Returns multiple properties in one call. This is more efficient than
 GetProperty.
 
 @param id unsigned the item whose properties we want to retrieve.
-@param propertyNames list of string name of the properties we want.
+@param propertyNames list of string name of the properties we want.  If the list contains no entries, all properties are sent.
 -->
 		<method name="GetProperties">
 			<annotation name="com.trolltech.QtDBus.QtTypeName.Out0" value="QVariantMap"/>
@@ -131,11 +169,16 @@ Triggered by the application to notify the applet that all properties of item
 		</signal>
 
 <!--
-Triggered by the application to notify applet it should retrieve the children
-for item @a id.
+Triggered by the application to notify display of a layout update, up to
+revision
+@param revsion The revision of the layout that we're currently on
+@param parent  If the layout update is only of a subtree, this is the parent
+         item for the entries that have changed.  It is zero if the
+		 whole layout should be considered invalid.
 -->
-		<signal name="ChildrenUpdated">
-			<arg type="u" name="id" direction="out" />
+		<signal name="LayoutUpdate">
+			<arg type="i" name="revision" direction="out" />
+			<arg type="u" name="parent" direction="out" />
 		</signal>
 
 <!-- End of interesting stuff -->
-- 
cgit v1.2.3