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 f9d061fcb446b111cb713befdefff1074e939b57..a2cee199a010c4fcfdf4fcaf81fdad1763400c8b 100644 (file)
--- 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.
  */