Mesa (master): gallium: comments for surface_copy(), surface_fill() in p_context.h

[Brian Paul]

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

Author: Brian Paul <brianp at vmware.com>
Date:   Thu Apr  9 18:40:24 2009 -0600

gallium: comments for surface_copy(), surface_fill() in p_context.h

---

 src/gallium/include/pipe/p_context.h |   11 +++++++++--
 1 files changed, 9 insertions(+), 2 deletions(-)

diff --git a/src/gallium/include/pipe/p_context.h b/src/gallium/include/pipe/p_context.h
index 29095dc..c5c8397 100644
--- a/src/gallium/include/pipe/p_context.h
+++ b/src/gallium/include/pipe/p_context.h
@@ -192,14 +192,21 @@ struct pipe_context {
     * Surface functions
     */
    /*@{*/
+
+   /**
+    * Copy a block of pixels from one surface to another.
+    * The surfaces must be of the same format.
+    */
    void (*surface_copy)(struct pipe_context *pipe,
 			struct pipe_surface *dest,
 			unsigned destx, unsigned desty,
-			struct pipe_surface *src, /* don't make this const - 
-						     need to map/unmap */
+			struct pipe_surface *src,
 			unsigned srcx, unsigned srcy,
 			unsigned width, unsigned height);
 
+   /**
+    * Fill a region of a surface with a constant value.
+    */
    void (*surface_fill)(struct pipe_context *pipe,
 			struct pipe_surface *dst,
 			unsigned dstx, unsigned dsty,