[gtk/present-toplevel-2: 176/178] toplevel: Documentation additions

[Matthias Clasen <matthiasc src gnome org>]

commit 35c01d022ecae2ba66cc1a2a92eb15a14b77fb6d
Author: Matthias Clasen <mclasen redhat com>
Date:   Mon Mar 9 20:59:21 2020 -0400

    toplevel: Documentation additions

 gdk/gdktoplevel.c | 29 ++++++++++++++++++++++++++++-
 1 file changed, 28 insertions(+), 1 deletion(-)
---
diff --git a/gdk/gdktoplevel.c b/gdk/gdktoplevel.c
index b54beab368..2f43135ef9 100644
--- a/gdk/gdktoplevel.c
+++ b/gdk/gdktoplevel.c
@@ -433,7 +433,7 @@ gdk_toplevel_set_keep_above (GdkToplevel *toplevel,
 /**
  * gdk_toplevel_set_keep_below:
  * @toplevel: a #GdkToplevel
- * @above: whether to keep @toplevel below other surfaces
+ * @below: whether to keep @toplevel below other surfaces
  *
  * Set if @surface must be kept below other surfaces.
  **/
@@ -482,6 +482,15 @@ gdk_toplevel_set_focus_on_map (GdkToplevel *toplevel,
   g_object_set (toplevel, "focus-on-map", focus_on_map, NULL);
 }
 
+/**
+ * gdk_toplevel_set_decorated:
+ * @toplevel: a #GdkToplevel
+ * @decorated: %TRUE to request decorations
+ *
+ * Setting @decorated to %FALSE hints the desktop environment
+ * that the surface has its own, client-side decorations and
+ * does not need to have window decorations added.
+ */
 void
 gdk_toplevel_set_decorated (GdkToplevel *toplevel,
                             gboolean     decorated)
@@ -491,6 +500,14 @@ gdk_toplevel_set_decorated (GdkToplevel *toplevel,
   g_object_set (toplevel, "decorated", decorated, NULL);
 }
 
+/**
+ * gdk_toplevel_set_deletable:
+ * @toplevel: a #GdkToplevel
+ * @deletable: %TRUE to request a delete button
+ *
+ * Setting @deletable to %TRUE hints the desktop environment
+ * that it should offer the user a way to close the surface.
+ */
 void
 gdk_toplevel_set_deletable (GdkToplevel *toplevel,
                             gboolean     deletable)
@@ -500,6 +517,16 @@ gdk_toplevel_set_deletable (GdkToplevel *toplevel,
   g_object_set (toplevel, "deletable", deletable, NULL);
 }
 
+/**
+ * gdk_toplevel_supports_edge_constraints:
+ * @toplevel: a #GdkToplevel
+ *
+ * Returns whether the desktop environment supports
+ * tiled window states.
+ *
+ * Returns: %TRUE if the desktop environment supports
+ *     tiled window states
+ */
 gboolean
 gdk_toplevel_supports_edge_constraints (GdkToplevel *toplevel)
 {