diff --git a/llvm/docs/CodeGenerator.html b/llvm/docs/CodeGenerator.html
index 918556332392..60f42607f07b 100644
--- a/llvm/docs/CodeGenerator.html
+++ b/llvm/docs/CodeGenerator.html
@@ -2019,6 +2019,11 @@ def : InstAlias<"fcomi $reg", (COM_FIr RST:$reg)>;
 <p>Instruction aliases can also have a Requires clause to make them
 subtarget specific.</p>
 
+<p>If the back-end supports it, the instruction printer can automatically emit
+   the alias rather than what's being aliased. It typically leads to better,
+   more readable code. If it's better to print out what's being aliased, then
+   pass a '0' as the third parameter to the InstAlias definition.</p>
+
 </div>
 
 </div>