[gtk+] Add documentation for gtk_window_set_titlebar

[Matthias Clasen <matthiasc src gnome org>]

commit 30d0542309e67a0de005064c43a9abad9dfd927b
Author: Matthias Clasen <mclasen redhat com>
Date:   Mon Mar 18 08:48:15 2013 -0400

    Add documentation for gtk_window_set_titlebar

 docs/reference/gtk/gtk3-sections.txt |    1 +
 gtk/gtk.symbols                      |    1 +
 gtk/gtkwindow.c                      |   15 +++++++++++++++
 gtk/gtkwindow.h                      |    1 +
 4 files changed, 18 insertions(+), 0 deletions(-)
---
diff --git a/docs/reference/gtk/gtk3-sections.txt b/docs/reference/gtk/gtk3-sections.txt
index 26a6ce6..7799586 100644
--- a/docs/reference/gtk/gtk3-sections.txt
+++ b/docs/reference/gtk/gtk3-sections.txt
@@ -5513,6 +5513,7 @@ gtk_window_get_resize_grip_area
 gtk_window_get_application
 gtk_window_set_application
 gtk_window_set_has_user_ref_count
+gtk_window_set_titlebar
 
 <SUBSECTION Standard>
 GTK_WINDOW
diff --git a/gtk/gtk.symbols b/gtk/gtk.symbols
index 4e2a326..8b2a97a 100644
--- a/gtk/gtk.symbols
+++ b/gtk/gtk.symbols
@@ -4051,6 +4051,7 @@ gtk_window_set_skip_pager_hint
 gtk_window_set_skip_taskbar_hint
 gtk_window_set_startup_id
 gtk_window_set_title
+gtk_window_set_titlebar
 gtk_window_set_transient_for
 gtk_window_set_attached_to
 gtk_window_set_type_hint
diff --git a/gtk/gtkwindow.c b/gtk/gtkwindow.c
index 0942938..21d4697 100644
--- a/gtk/gtkwindow.c
+++ b/gtk/gtkwindow.c
@@ -3415,6 +3415,21 @@ gtk_window_set_geometry_hints (GtkWindow       *window,
   gtk_widget_queue_resize_no_redraw (GTK_WIDGET (window));
 }
 
+/**
+ * gtk_window_set_titlebar:
+ * @window: a #GtkWindow
+ * @titlebar: the widget to use as titlebar
+ *
+ * Sets a custom titlebar for @window.
+ *
+ * If you set a custom titlebar, GTK+ will do its best to convince
+ * the window manager not to put its own titlebar on the window.
+ * Depending on the system, this function may not work for a window
+ * that is already visible, so you set the titlebar before calling
+ * gtk_widget_show().
+ *
+ * Since: 3.10
+ */
 void
 gtk_window_set_titlebar (GtkWindow *window,
                          GtkWidget *titlebar)
diff --git a/gtk/gtkwindow.h b/gtk/gtkwindow.h
index 836f0a4..6472a7e 100644
--- a/gtk/gtkwindow.h
+++ b/gtk/gtkwindow.h
@@ -348,6 +348,7 @@ gboolean gtk_window_resize_grip_is_visible (GtkWindow    *window);
 gboolean gtk_window_get_resize_grip_area   (GtkWindow    *window,
                                             GdkRectangle *rect);
 
+GDK_AVAILABLE_IN_3_10
 void     gtk_window_set_titlebar           (GtkWindow    *window,
                                             GtkWidget    *titlebar);