[intel] Add some doxygen notes on what the bufmgr_fake block members mean.
authorEric Anholt <eric@anholt.net>
Thu, 15 Nov 2007 22:00:17 +0000 (14:00 -0800)
committerEric Anholt <eric@anholt.net>
Fri, 16 Nov 2007 23:36:18 +0000 (15:36 -0800)
src/mesa/drivers/dri/common/dri_bufmgr_fake.c

index 48a0a3caa52b4d51ac2b876b06b0edb976229e0c..c31bd7c6b0d122071c8ce398d3d2960b4071e44b 100644 (file)
@@ -66,7 +66,7 @@ struct fake_buffer_reloc
    dri_bo *reloc_buf;
    dri_bo *target_buf;
    GLuint offset;
-   GLuint delta;                /* not needed? */
+   GLuint delta;
    GLuint validate_flags;
    GLboolean relocated;
 };
@@ -75,10 +75,19 @@ struct block {
    struct block *next, *prev;
    struct mem_block *mem;      /* BM_MEM_AGP */
 
+   /**
+    * Marks that the block is currently in the aperture and has yet to be
+    * fenced.
+    */
    unsigned on_hardware:1;
+   /**
+    * Marks that the block is currently fenced (being used by rendering) and
+    * can't be freed until @fence is passed.
+    */
    unsigned fenced:1;
 
-   unsigned fence;             /* BM_MEM_AGP, Split to read_fence, write_fence */
+   /** Fence cookie for the block. */
+   unsigned fence; /* Split to read_fence, write_fence */
 
    dri_bo *bo;
    void *virtual;