[gtk+] Small doc improvements

[Matthias Clasen <matthiasc src gnome org>]

commit 07d71cf9455ff1afad242e47caf9d1dfffa4925a
Author: Matthias Clasen <mclasen redhat com>
Date:   Sat Nov 16 15:00:16 2013 -0500

    Small doc improvements

 gtk/gtkapplicationwindow.c |    4 +++-
 gtk/gtkheaderbar.c         |    3 ++-
 2 files changed, 5 insertions(+), 2 deletions(-)
---
diff --git a/gtk/gtkapplicationwindow.c b/gtk/gtkapplicationwindow.c
index 079f4bb..caee9b1 100644
--- a/gtk/gtkapplicationwindow.c
+++ b/gtk/gtkapplicationwindow.c
@@ -82,7 +82,9 @@
  * looks on different platforms).
  * This behaviour can be overridden with the #GtkApplicationWindow:show-menubar
  * property. If the desktop environment does not display the application
- * menu, then it will automatically be included in the menubar.
+ * menu, then it will automatically be included in the menubar. It can
+ * also be shown as part of client-side window decorations, e.g. by
+ * using gtk_header_bar_set_show_fallback_app_menu().
  *
  * <example><title>A GtkApplicationWindow with a menubar</title>
  * <programlisting><![CDATA[
diff --git a/gtk/gtkheaderbar.c b/gtk/gtkheaderbar.c
index 24be729..a22b95c 100644
--- a/gtk/gtkheaderbar.c
+++ b/gtk/gtkheaderbar.c
@@ -1908,7 +1908,8 @@ gtk_header_bar_get_show_fallback_app_menu (GtkHeaderBar *bar)
  * @setting: %TRUE to enable the fallback application menu
  *
  * Sets whether this header bar may show a menu button
- * for the application menu when needed.
+ * for the application menu when it is not shown by the
+ * desktop environment.
  *
  * Since: 3.12
  */