[gtk/wip/hadess/window-present-docs: 5/5] surface: Advise using gtk_window_present_with_time()

[Bastien Nocera <hadess src gnome org>]

commit 91ad2eef5c74ea5f03439bb3cc1b10ee0a9f2871
Author: Bastien Nocera <hadess hadess net>
Date:   Wed Jul 25 17:48:52 2018 +0200

    surface: Advise using gtk_window_present_with_time()
    
    Rather than gtk_window_present()

 gdk/gdksurface.c | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)
---
diff --git a/gdk/gdksurface.c b/gdk/gdksurface.c
index 8a1f66f0bc..7d6e951769 100644
--- a/gdk/gdksurface.c
+++ b/gdk/gdksurface.c
@@ -4098,7 +4098,7 @@ gdk_surface_create_similar_surface (GdkSurface *     surface,
  * @surface: a #GdkSurface
  * @timestamp: timestamp of the event triggering the surface focus
  *
- * Sets keyboard focus to @surface. In most cases, gtk_window_present()
+ * Sets keyboard focus to @surface. In most cases, gtk_window_present_with_time()
  * should be used on a #GtkWindow, rather than calling this function.
  *
  **/
@@ -4491,7 +4491,7 @@ gdk_surface_iconify (GdkSurface *surface)
  * Attempt to deiconify (unminimize) @surface. On X11 the window manager may
  * choose to ignore the request to deiconify. When using GTK,
  * use gtk_window_deiconify() instead of the #GdkSurface variant. Or better yet,
- * you probably want to use gtk_window_present(), which raises the surface, focuses it,
+ * you probably want to use gtk_window_present_with_time(), which raises the surface, focuses it,
  * unminimizes it, and puts it on the current desktop.
  *
  **/