[gtk+] Document gtk_application_get_menu_by_id

[Matthias Clasen <matthiasc src gnome org>]

commit d1099b1759cac4efd8f76201467e5d5a30e71e1f
Author: Matthias Clasen <mclasen redhat com>
Date:   Mon Jul 7 19:44:39 2014 -0400

    Document gtk_application_get_menu_by_id

 docs/reference/gtk/gtk3-sections.txt               |    1 +
 gtk/gtkapplication.c                               |   16 ++++++++++++++++
 2 files changed, 17 insertions(+), 0 deletions(-)
---
diff --git a/docs/reference/gtk/gtk3-overrides.txt b/docs/reference/gtk/gtk3-overrides.txt
new file mode 100644
index 0000000..e69de29
diff --git a/docs/reference/gtk/gtk3-sections.txt b/docs/reference/gtk/gtk3-sections.txt
index 7b39805..056e67d 100644
--- a/docs/reference/gtk/gtk3-sections.txt
+++ b/docs/reference/gtk/gtk3-sections.txt
@@ -7398,6 +7398,7 @@ gtk_application_get_app_menu
 gtk_application_set_app_menu
 gtk_application_get_menubar
 gtk_application_set_menubar
+gtk_application_get_menu_by_id
 
 gtk_application_add_accelerator
 gtk_application_remove_accelerator
diff --git a/docs/reference/libgail-util/gail-libgail-util3-overrides.txt 
b/docs/reference/libgail-util/gail-libgail-util3-overrides.txt
new file mode 100644
index 0000000..e69de29
diff --git a/gtk/gtkapplication.c b/gtk/gtkapplication.c
index e77cdc4..d2a8dad 100644
--- a/gtk/gtkapplication.c
+++ b/gtk/gtkapplication.c
@@ -71,6 +71,8 @@
  * associated with #GtkApplicationWindow and to the “activate” and
  * 'open' #GApplication methods.
  *
+ * ## Automatic resources ## {#automatic-resources}
+ *
  * #GtkApplication will automatically load menus from the #GtkBuilder
  * file located at "gtk/menus.ui", relative to the application's
  * resource base path (see g_application_set_resource_base_path()).  The
@@ -1705,6 +1707,20 @@ gtk_application_handle_window_map (GtkApplication *application,
   gtk_application_impl_handle_window_map (application->priv->impl, window);
 }
 
+/**
+ * gtk_application_get_menu_by_id:
+ * @application: a #GtkApplication
+ * @id: the id of the menu to look up
+ *
+ * Gets a menu from automatically loaded resources.
+ * See [Automatic resources][automatic-resources]
+ * for more information.
+ *
+ * Returns: (transfer full): Gets the menu with the
+ *     given id from the automatically loaded resources
+ *
+ * Since: 3.14
+ */
 GMenu *
 gtk_application_get_menu_by_id (GtkApplication *application,
                                 const gchar    *id)