From: Eric Anholt <eric@anholt.net>
Date: Tue, 4 Mar 2008 21:45:41 +0000 (-0800)
Subject: Clarify when WAIT_LAZY is relevant to users.
X-Git-Tag: android-x86-1.6~471
X-Git-Url: http://git.osdn.net/view?a=commitdiff_plain;h=a6a2f2c8c491617de702dc7d62bb55cbada4d42b;p=android-x86%2Fexternal-libdrm.git

Clarify when WAIT_LAZY is relevant to users.
---

diff --git a/shared-core/drm.h b/shared-core/drm.h
index 213d3c7a..663696c1 100644
--- a/shared-core/drm.h
+++ b/shared-core/drm.h
@@ -645,6 +645,13 @@ struct drm_set_version {
 
 #define DRM_FENCE_FLAG_EMIT                0x00000001
 #define DRM_FENCE_FLAG_SHAREABLE           0x00000002
+/**
+ * On hardware with no interrupt events for operation completion,
+ * indicates that the kernel should sleep while waiting for any blocking
+ * operation to complete rather than spinning.
+ *
+ * Has no effect otherwise.
+ */
 #define DRM_FENCE_FLAG_WAIT_LAZY           0x00000004
 #define DRM_FENCE_FLAG_NO_USER             0x00000010
 
@@ -794,13 +801,12 @@ struct drm_fence_arg {
  * with it as a result of this operation
  */
 #define DRM_BO_HINT_DONT_FENCE  0x00000004
-/*
- * Sleep while waiting for the operation to complete.
- * Without this flag, the kernel will, instead, spin
- * until this operation has completed. I'm not sure
- * why you would ever want this, so please always
- * provide DRM_BO_HINT_WAIT_LAZY to any operation
- * which may block
+/**
+ * On hardware with no interrupt events for operation completion,
+ * indicates that the kernel should sleep while waiting for any blocking
+ * operation to complete rather than spinning.
+ *
+ * Has no effect otherwise.
  */
 #define DRM_BO_HINT_WAIT_LAZY   0x00000008
 /*