Mesa (master): gallium: comments and whitespace fixes

[Brian Paul]

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

Author: Brian Paul <brianp at vmware.com>
Date:   Fri Apr 16 08:21:34 2010 -0600

gallium: comments and whitespace fixes

---

 src/gallium/include/pipe/p_state.h |   21 +++++++++++++--------
 1 files changed, 13 insertions(+), 8 deletions(-)

diff --git a/src/gallium/include/pipe/p_state.h b/src/gallium/include/pipe/p_state.h
index d281d69..24cb266 100644
--- a/src/gallium/include/pipe/p_state.h
+++ b/src/gallium/include/pipe/p_state.h
@@ -288,9 +288,6 @@ struct pipe_surface
 };
 
 
-
-
-
 /**
  * A view into a texture that can be bound to a shader stage.
  */
@@ -309,6 +306,9 @@ struct pipe_sampler_view
 };
 
 
+/**
+ * Subregion of 1D/2D/3D image resource.
+ */
 struct pipe_box
 {
    unsigned x;
@@ -320,7 +320,9 @@ struct pipe_box
 };
 
 
-
+/**
+ * A memory object/resource such as a vertex buffer or texture.
+ */
 struct pipe_resource
 {
    struct pipe_reference reference;
@@ -334,13 +336,16 @@ struct pipe_resource
 
    unsigned last_level:8;    /**< Index of last mipmap level present/defined */
    unsigned nr_samples:8;    /**< for multisampled surfaces, nr of samples */
-   unsigned _usage:8;	       /* PIPE_USAGE_x (not a bitmask) */
+   unsigned _usage:8;	     /**< PIPE_USAGE_x (not a bitmask) */
 
-   unsigned bind;	       /* PIPE_BIND_x */
-   unsigned flags;	       /* PIPE_RESOURCE_FLAG_x */
+   unsigned bind;	     /**< bitmask of PIPE_BIND_x */
+   unsigned flags;	     /**< bitmask of PIPE_RESOURCE_FLAG_x */
 };
 
 
+/**
+ * Extra indexing info for (cube) texture resources.
+ */
 struct pipe_subresource
 {
    unsigned face:16;
@@ -349,7 +354,7 @@ struct pipe_subresource
 
 
 /**
- * Transfer object.  For data transfer to/from a texture.
+ * Transfer object.  For data transfer to/from a resource.
  */
 struct pipe_transfer
 {