[gtk+] Docs: GtkApplication: Hint about GtkActionMap

[Murray Cumming <murrayc src gnome org>]

commit 79758e3d98816b06ceb54cfc36e47751a12c9cb8
Author: Murray Cumming <murrayc murrayc com>
Date:   Thu Mar 22 19:49:47 2012 +0100

    Docs: GtkApplication: Hint about GtkActionMap

 gtk/gtkapplication.c |   17 +++++++++++++----
 1 files changed, 13 insertions(+), 4 deletions(-)
---
diff --git a/gtk/gtkapplication.c b/gtk/gtkapplication.c
index c825777..3513c71 100644
--- a/gtk/gtkapplication.c
+++ b/gtk/gtkapplication.c
@@ -75,12 +75,15 @@
  * associated with #GtkApplicationWindow and to the 'activate' and
  * 'open' #GApplication methods.
  *
- * To set an application menu on a GtkApplication, use
+ * To set an application menu for a GtkApplication, use
  * gtk_application_set_app_menu(). The #GMenuModel that this function
  * expects is usually constructed using #GtkBuilder, as seen in the
- * following example. To set a menubar that will be automatically picked
- * up by #GApplicationWindows, use gtk_application_set_menubar(). GTK+
- * makes these menus appear as expected, depending on the platform
+ * following example. To specify a menubar that will be shown by
+ * #GApplicationWindows, use gtk_application_set_menubar(). Use the base
+ * #GActionMap interface to add actions, to respond to the user
+ * selecting these menu items.
+ *
+ * GTK+ displays these menus as expected, depending on the platform
  * the application is running on.
  *
  * <figure label="Menu integration in OS X">
@@ -1005,6 +1008,9 @@ gtk_application_remove_accelerator (GtkApplication *application,
  * If supported, the application menu will be rendered by the desktop
  * environment.
  *
+ * Use the base #GActionMap interface to add actions, to respond to the user
+ * selecting these menu items.
+ *
  * Since: 3.4
  */
 void
@@ -1069,6 +1075,9 @@ gtk_application_get_app_menu (GtkApplication *application)
  * example, the application menu may be rendered by the desktop shell
  * while the menubar (if set) remains in each individual window.
  *
+ * Use the base #GActionMap interface to add actions, to respond to the user
+ * selecting these menu items.
+ *
  * Since: 3.4
  */
 void