diff --git a/lib/Target/README.txt b/lib/Target/README.txt
index 23572cd6bc5..e9133721f48 100644
--- a/lib/Target/README.txt
+++ b/lib/Target/README.txt
@@ -784,3 +784,15 @@ int test(int x_offs) {
 }
 
 //===---------------------------------------------------------------------===//
+
+Reassociate should turn things like:
+
+int factorial(int X) {
+ return X*X*X*X*X*X*X*X;
+}
+
+into llvm.powi calls, allowing the code generator to produce balanced
+multiplication trees.
+
+//===---------------------------------------------------------------------===//
+