From: Marek Olšák <maraeo@gmail.com>
Date: Wed, 11 Aug 2010 13:11:37 +0000 (+0200)
Subject: util: copy the u_staging commit message to the code
X-Git-Url: https://git.libre-soc.org/?a=commitdiff_plain;h=4b20ad7559271a7785193094a3f110ef78e65253;p=mesa.git

util: copy the u_staging commit message to the code
---

diff --git a/src/gallium/auxiliary/util/u_staging.h b/src/gallium/auxiliary/util/u_staging.h
index f5976dadb15..602faa2971d 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