From c3c338dcc0a7f4d96283efb583268b9983147786 Mon Sep 17 00:00:00 2001
From: Emmanuele Bassi <ebassi@gnome.org>
Date: Mon, 9 Feb 2015 16:09:25 +0000
Subject: [PATCH] docs: We do not support non-core GL profiles

No need to mention that some API only works on core GL profiles in the
GdkGLContext docs.

https://bugzilla.gnome.org/show_bug.cgi?id=741946
---
 gdk/gdkglcontext.c | 26 ++++++++++++++------------
 1 file changed, 14 insertions(+), 12 deletions(-)

diff --git a/gdk/gdkglcontext.c b/gdk/gdkglcontext.c
index 06f19e875f..aac9e42223 100644
--- a/gdk/gdkglcontext.c
+++ b/gdk/gdkglcontext.c
@@ -49,6 +49,14 @@
  * #GdkWindow, which you typically get during the realize call
  * of a widget.
  *
+ * A #GdkGLContext is not realized until either gdk_gl_context_make_current(),
+ * or until it is realized using gdk_gl_context_realize(). It is possible to
+ * specify details of the GL context like the OpenGL version to be used, or
+ * whether the GL context should have extra state validation enabled after
+ * calling gdk_window_create_gl_context() by calling gdk_gl_context_realize().
+ * If the realization fails you have the option to change the settings of the
+ * #GdkGLContext and try again.
+ *
  * ## Using a GdkGLContext ##
  *
  * You will need to make the #GdkGLContext the current context
@@ -404,10 +412,8 @@ gdk_gl_context_has_frame_terminator (GdkGLContext *context)
  * run time checking. This is useful during development, but has
  * additional overhead.
  *
- * The #GdkGLContext must not be realized.
- *
- * This function has effect only on #GdkGLContexts created using
- * the %GDK_GL_PROFILE_3_2_CORE profile.
+ * The #GdkGLContext must not be realized or made current prior to
+ * calling this function.
  *
  * Since: 3.16
  */
@@ -457,10 +463,8 @@ gdk_gl_context_get_debug_enabled (GdkGLContext *context)
  * compatible contexts, on the other hand, must support both deprecated and
  * non deprecated functionality.
  *
- * The #GdkGLContext must not be realized.
- *
- * This function has effect only on #GdkGLContexts created using
- * the %GDK_GL_PROFILE_3_2_CORE profile.
+ * The #GdkGLContext must not be realized or made current prior to calling
+ * this function.
  *
  * Since: 3.16
  */
@@ -508,10 +512,8 @@ gdk_gl_context_get_forward_compatible (GdkGLContext *context)
  *
  * Setting @major and @minor to zero will use the default values.
  *
- * The #GdkGLContext must not be realized.
- *
- * This function has effect only on #GdkGLContexts created using
- * the %GDK_GL_PROFILE_3_2_CORE profile.
+ * The #GdkGLContext must not be realized or made current prior to calling
+ * this function.
  *
  * Since: 3.16
  */