[gtk+] glarea: Update documentation

[Emmanuele Bassi <ebassi src gnome org>]

commit ec112a772b35ce3dca23d194f704615eef7d29cc
Author: Emmanuele Bassi <ebassi gnome org>
Date:   Thu Feb 12 13:19:21 2015 +0000

    glarea: Update documentation
    
    Drop the fixed pipeline example code.
    
    https://bugzilla.gnome.org/show_bug.cgi?id=744394

 gtk/gtkglarea.c |   33 +++++++--------------------------
 1 files changed, 7 insertions(+), 26 deletions(-)
---
diff --git a/gtk/gtkglarea.c b/gtk/gtkglarea.c
index 7de3182..03c4024 100644
--- a/gtk/gtkglarea.c
+++ b/gtk/gtkglarea.c
@@ -89,32 +89,12 @@
  *   }
  * ]|
  *
- * The `draw_an_object()` function draws a 2D, gold-colored
- * triangle:
- *
- * |[<!-- language="C" -->
- *   static void
- *   draw_an_object (void)
- *   {
- *     // set the color
- *     glColor3f (1.0f, 0.85f, 0.35f);
- *
- *     // draw our triangle
- *     glBegin (GL_TRIANGLES);
- *     {
- *       glVertex3f ( 0.0f,  0.6f,  0.0f);
- *       glVertex3f (-0.2f, -0.3f,  0.0f);
- *       glVertex3f ( 0.2f, -0.3f,  0.0f);
- *     }
- *     glEnd ();
- *   }
- * ]|
- *
- * This is an extremely simple example; in a real-world application you
- * would probably replace the immediate mode drawing with persistent
- * geometry primitives, like a Vertex Buffer Object, and only redraw what
- * changed in your scene.
+ * If you need to initialize OpenGL state, e.g. buffer objects or
+ * shadres, you should use the #GtkWidget::realize signal; you
+ * can use the #GtkWidget::unrealize signal to clean up.
  *
+ * If you need to change the options for creating the #GdkGLContext
+ * you should use the #GtkGLArea::create-context signal.
  */
 
 typedef struct {
@@ -1036,7 +1016,8 @@ gtk_gl_area_get_profile (GtkGLArea *area)
  * @profile: a #GdkGLProfile
  *
  * Sets the profile type to be used when creating the context for the widget.
- * This must be called before the are has been realized.
+ *
+ * This function must be called before the area has been realized.
  *
  * Since: 3.16
  */