From: José Fonseca <jfonseca@vmware.com>
Date: Sun, 17 Oct 2010 20:41:45 +0000 (-0700)
Subject: gallivm: Comment lp_build_insert_new_block().
X-Git-Url: https://git.libre-soc.org/?a=commitdiff_plain;h=4dfb43c6a655574a9b59b552d05408c027d8cfaa;p=mesa.git

gallivm: Comment lp_build_insert_new_block().
---

diff --git a/src/gallium/auxiliary/gallivm/lp_bld_flow.c b/src/gallium/auxiliary/gallivm/lp_bld_flow.c
index f9d061fcb44..a2cee199a01 100644
--- a/src/gallium/auxiliary/gallivm/lp_bld_flow.c
+++ b/src/gallium/auxiliary/gallivm/lp_bld_flow.c
@@ -39,6 +39,14 @@
 
 
 /**
+ * Insert a new block, right where builder is pointing to.
+ *
+ * This is useful important not only for aesthetic reasons, but also for
+ * performance reasons, as frequently run blocks should be laid out next to
+ * each other and fall-throughs maximized.
+ *
+ * See also llvm/lib/Transforms/Scalar/BasicBlockPlacement.cpp.
+ *
  * Note: this function has no dependencies on the flow code and could
  * be used elsewhere.
  */