Mesa (master): i965: Add comments to the new brw_state_state structure' s fields.

[Kenneth Graunke]

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

Author: Kenneth Graunke <kenneth at whitecape.org>
Date:   Sun Sep  1 17:14:25 2013 -0700

i965: Add comments to the new brw_state_state structure's fields.

These are largely based on the similar fields in brw->wm.

v2: Add a better comment than "Scratch buffer".

Signed-off-by: Kenneth Graunke <kenneth at whitecape.org>
Reviewed-by: Eric Anholt <eric at anholt.net>
Reviewed-by: Paul Berry <stereotype441 at gmail.com>

---

 src/mesa/drivers/dri/i965/brw_context.h |   10 ++++++++++
 1 files changed, 10 insertions(+), 0 deletions(-)

diff --git a/src/mesa/drivers/dri/i965/brw_context.h b/src/mesa/drivers/dri/i965/brw_context.h
index c566bba..6c04074 100644
--- a/src/mesa/drivers/dri/i965/brw_context.h
+++ b/src/mesa/drivers/dri/i965/brw_context.h
@@ -835,15 +835,25 @@ struct brw_query_object {
  */
 struct brw_stage_state
 {
+   /**
+    * Optional scratch buffer used to store spilled register values and
+    * variably-indexed GRF arrays.
+    */
    drm_intel_bo *scratch_bo;
+
+   /** Pull constant buffer */
    drm_intel_bo *const_bo;
+
    /** Offset in the program cache to the program */
    uint32_t prog_offset;
+
+   /** Offset in the batchbuffer to Gen4-5 pipelined state (VS/WM/GS_STATE). */
    uint32_t state_offset;
 
    uint32_t push_const_offset; /* Offset in the batchbuffer */
    int push_const_size; /* in 256-bit register increments */
 
+   /* Binding table: pointers to SURFACE_STATE entries. */
    uint32_t bind_bo_offset;
    uint32_t surf_offset[BRW_MAX_VEC4_SURFACES];