From 8031910e21a22d103f0ee1e45928e857df43f2e0 Mon Sep 17 00:00:00 2001
From: Matthias Clasen <mclasen@redhat.com>
Date: Fri, 3 Jul 2009 15:17:26 -0400
Subject: [PATCH] Add doc stubs

---
 gdk/gdkoffscreenwindow.c | 28 +++++++++++++++++++++++-----
 gdk/gdkwindow.c          |  8 +++++++-
 2 files changed, 30 insertions(+), 6 deletions(-)

diff --git a/gdk/gdkoffscreenwindow.c b/gdk/gdkoffscreenwindow.c
index 438cc0c1a..03d8fe04f 100644
--- a/gdk/gdkoffscreenwindow.c
+++ b/gdk/gdkoffscreenwindow.c
@@ -832,12 +832,12 @@ gdk_offscreen_window_get_pointer (GdkWindow       *window,
  * gdk_offscreen_window_get_pixmap:
  * @window: a #GdkWindow
  *
- * Gets the offscreen pixmap that an offscreen window renders into. If
- * you need to keep this around over window resizes, you need to add a
- * reference to it.
+ * Gets the offscreen pixmap that an offscreen window renders into.
+ * If you need to keep this around over window resizes, you need to
+ * add a reference to it.
  *
- * Returns: The offscreen pixmap, or NULL if not offscreen
- **/
+ * Returns: The offscreen pixmap, or %NULL if not offscreen
+ */
 GdkPixmap *
 gdk_offscreen_window_get_pixmap (GdkWindow *window)
 {
@@ -1155,6 +1155,13 @@ gdk_offscreen_window_queue_translation (GdkWindow *window,
 {
 }
 
+/**
+ * gdk_offscreen_window_set_embedder:
+ * @window: a #GdkWindow
+ * @embedder: the #GdkWindow that @window gets embedded in
+ *
+ * Since: 2.18
+ */
 void
 gdk_offscreen_window_set_embedder (GdkWindow     *window,
 				   GdkWindow     *embedder)
@@ -1184,6 +1191,17 @@ gdk_offscreen_window_set_embedder (GdkWindow     *window,
   offscreen->embedder = embedder;
 }
 
+/**
+ * gdk_offscreen_window_get_embedder:
+ * @window: a #GdkWindow
+ *
+ * Gets the window that @window is embedded in.
+ *
+ * Returns: the embedding #GdkWindow, or %NULL if @window is not an
+ *     embedded offscreen window
+ *
+ * Since: 2.18
+ */
 GdkWindow *
 gdk_offscreen_window_get_embedder (GdkWindow *window)
 {
diff --git a/gdk/gdkwindow.c b/gdk/gdkwindow.c
index cda7e8320..7599f2089 100644
--- a/gdk/gdkwindow.c
+++ b/gdk/gdkwindow.c
@@ -1469,7 +1469,7 @@ gdk_window_reparent (GdkWindow *window,
  * Returns: %TRUE if the window has a native window, %FALSE otherwise
  *
  * Since: 2.18
- **/
+ */
 gboolean
 gdk_window_ensure_native (GdkWindow *window)
 {
@@ -8729,6 +8729,12 @@ gdk_pointer_grab (GdkWindow *	  window,
   return res;
 }
 
+/**
+ * gdk_window_geometry_changed:
+ * @window: a #GdkWindow
+ *
+ * Since: 2.18
+ */
 void
 gdk_window_geometry_changed (GdkWindow *window)
 {