[glib/wip/menus-rebase2] More docs

[Matthias Clasen <matthiasc src gnome org>]

commit 9095d229bdc783168f4abf45262c7041c07fc68d
Author: Matthias Clasen <mclasen redhat com>
Date:   Sat Nov 26 11:30:39 2011 -0500

    More docs

 gio/gapplication.c |   11 ++++++++---
 1 files changed, 8 insertions(+), 3 deletions(-)
---
diff --git a/gio/gapplication.c b/gio/gapplication.c
index ee7ccbd..1858e94 100644
--- a/gio/gapplication.c
+++ b/gio/gapplication.c
@@ -89,7 +89,11 @@
  * GApplication also implements the #GActionGroup interface and lets you
  * easily export actions by adding them with g_application_set_action_group().
  * When invoking an action by calling g_action_group_activate_action() on
- * the application, it is always invoked in the primary instance.
+ * the application, it is always invoked in the primary instance. The actions
+ * are also exported on the session bus, and GIO provides the #GDBusActionGroup
+ * wrapper to conveniently access them remotely. Additionally,
+ * g_application_set_menu() can be used to export representation data
+ * for the actions, in the form of a  #GMenuModel.
  *
  * There is a number of different entry points into a #GApplication:
  * <itemizedlist>
@@ -413,7 +417,7 @@ g_application_set_property (GObject      *object,
  *
  * Sets or unsets the group of actions associated with the application.
  *
- * These actions are the actions that can be remotely invoked.
+ * These actions can be invoked remotely.
  *
  * It is an error to call this function after the application has been
  * registered.
@@ -441,7 +445,8 @@ g_application_set_action_group (GApplication *application,
  * @application: a #GApplication
  * @menu: (allow-none): a #GMenuModel, or %NULL
  *
- * Sets or unsets the menu associated with the application.
+ * Sets or unsets the menu associated with the application. The menu
+ * provides representation data for the exported actions of @application.
  *
  * It is an error to call this function after the application has been
  * registered.