Mesa (master): vbo: more comments

[Brian Paul]

Module: Mesa
Branch: master
Commit: da9adb9613ff55638e37186c89bfa4a558cafb28
URL:    http://cgit.freedesktop.org/mesa/mesa/commit/?id=da9adb9613ff55638e37186c89bfa4a558cafb28

Author: Brian Paul <brianp at vmware.com>
Date:   Mon Feb 21 15:11:44 2011 -0700

vbo: more comments

---

 src/mesa/vbo/vbo_exec_api.c |    5 +++++
 1 files changed, 5 insertions(+), 0 deletions(-)

diff --git a/src/mesa/vbo/vbo_exec_api.c b/src/mesa/vbo/vbo_exec_api.c
index 19bcd0b..c4d39d8 100644
--- a/src/mesa/vbo/vbo_exec_api.c
+++ b/src/mesa/vbo/vbo_exec_api.c
@@ -932,6 +932,9 @@ void vbo_exec_vtx_destroy( struct vbo_exec_context *exec )
 }
 
 
+/**
+ * Called upon first glVertex, glColor, glTexCoord, etc.
+ */
 void vbo_exec_BeginVertices( struct gl_context *ctx )
 {
    struct vbo_exec_context *exec = &vbo_context(ctx)->exec;
@@ -944,6 +947,7 @@ void vbo_exec_BeginVertices( struct gl_context *ctx )
 
 
 /**
+ * Called via ctx->Driver.FlushVertices()
  * \param flags  bitmask of FLUSH_STORED_VERTICES, FLUSH_UPDATE_CURRENT
  */
 void vbo_exec_FlushVertices( struct gl_context *ctx, GLuint flags )
@@ -957,6 +961,7 @@ void vbo_exec_FlushVertices( struct gl_context *ctx, GLuint flags )
 #endif
 
    if (exec->ctx->Driver.CurrentExecPrimitive != PRIM_OUTSIDE_BEGIN_END) {
+      /* We've had glBegin but not glEnd! */
 #ifdef DEBUG
       exec->flush_call_depth--;
       assert(exec->flush_call_depth == 0);