Mesa (master): util: copy the u_staging commit message to the code

[Marek Olšák]

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

Author: Marek Olšák <maraeo at gmail.com>
Date:   Wed Aug 11 15:11:37 2010 +0200

util: copy the u_staging commit message to the code

---

 src/gallium/auxiliary/util/u_staging.h |   10 +++++++++-
 1 files changed, 9 insertions(+), 1 deletions(-)

diff --git a/src/gallium/auxiliary/util/u_staging.h b/src/gallium/auxiliary/util/u_staging.h
index f5976da..602faa2 100644
--- a/src/gallium/auxiliary/util/u_staging.h
+++ b/src/gallium/auxiliary/util/u_staging.h
@@ -1,4 +1,12 @@
-/* Implement transfers using staging resources like in DirectX 10/11 */
+/* Direct3D 10/11 has no concept of transfers. Applications instead
+ * create resources with a STAGING or DYNAMIC usage, copy between them
+ * and the real resource and use Map to map the STAGING/DYNAMIC resource.
+ *
+ * This util module allows to implement Gallium drivers as a Direct3D
+ * driver would be implemented: transfers allocate a resource with
+ * PIPE_USAGE_STAGING, and copy the data between it and the real resource
+ * with resource_copy_region.
+ */
 
 #ifndef U_STAGING_H
 #define U_STAGING_H