Mesa (master): dri: Add an explanatory comment for an important driver entrypoint.

[Eric Anholt]

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

Author: Eric Anholt <eric at anholt.net>
Date:   Thu Sep 26 10:33:12 2013 -0700

dri: Add an explanatory comment for an important driver entrypoint.

Reviewed-by: Kenneth Graunke <kenneth at whitecape.org>

---

 src/mesa/drivers/dri/common/dri_util.c |    7 +++++++
 1 files changed, 7 insertions(+), 0 deletions(-)

diff --git a/src/mesa/drivers/dri/common/dri_util.c b/src/mesa/drivers/dri/common/dri_util.c
index b95970d..fec05a0 100644
--- a/src/mesa/drivers/dri/common/dri_util.c
+++ b/src/mesa/drivers/dri/common/dri_util.c
@@ -73,6 +73,13 @@ setupLoaderExtensions(__DRIscreen *psp,
     }
 }
 
+/**
+ * This is the first entrypoint in the driver called by the DRI driver loader
+ * after dlopen()ing it.
+ *
+ * It's used to create global state for the driver across contexts on the same
+ * Display.
+ */
 static __DRIscreen *
 dri2CreateNewScreen(int scrn, int fd,
 		    const __DRIextension **extensions,