llvm
diff --git a/‎llvm/docs/Passes.rst
+8 b/‎llvm/docs/Passes.rst
+8
diff --git a/‎llvm/docs/ReleaseNotes.rst
+4-1 b/‎llvm/docs/ReleaseNotes.rst
+4-1
diff --git a/‎llvm/include/llvm/InitializePasses.h
+1 b/‎llvm/include/llvm/InitializePasses.h
+1
diff --git a/‎llvm/include/llvm/LinkAllPasses.h
+1 b/‎llvm/include/llvm/LinkAllPasses.h
+1
diff --git a/‎llvm/include/llvm/Transforms/Utils.h
+6 b/‎llvm/include/llvm/Transforms/Utils.h
+6
diff --git a/‎llvm/lib/Transforms/Utils/CMakeLists.txt
+1 b/‎llvm/lib/Transforms/Utils/CMakeLists.txt
+1
@@ -691,6 +691,14 @@ the mess.
 An interprocedural variant of :ref:`Sparse Conditional Constant Propagation
 <passes-sccp>`.
 
+``-ir-canonicalizer``: Transforms IR into canonical form
+--------------------------------------------------------
+
+This pass aims to transform LLVM Modules into a canonical form by reordering and
+renaming instructions while preserving the same semantics. The canonicalizer makes
+it easier to spot semantic differences while diffing two modules which have undergone
+two different passes.
+
 ``-jump-threading``: Jump Threading
 -----------------------------------
 
 
@@ -41,7 +41,10 @@ Non-comprehensive list of changes in this release
    for adding a new subsection.
 
 * ...
-
+* Added a new IRCanonicalizer pass which aims to transform LLVM modules into
+  a canonical form by reordering and renaming instructions while preserving the
+  same semantics. The canonicalizer makes it easier to spot semantic differences
+  when diffing two modules which have undergone different passes.
 
 .. NOTE
    If you would like to document a larger change, then you can add a
 
@@ -179,6 +179,7 @@ void initializeHotColdSplittingLegacyPassPass(PassRegistry&);
 void initializeHWAddressSanitizerLegacyPassPass(PassRegistry &);
 void initializeIPCPPass(PassRegistry&);
 void initializeIPSCCPLegacyPassPass(PassRegistry&);
+void initializeIRCanonicalizerPass(PassRegistry&);
 void initializeIRCELegacyPassPass(PassRegistry&);
 void initializeIRTranslatorPass(PassRegistry&);
 void initializeIVUsersWrapperPassPass(PassRegistry&);
 
@@ -118,6 +118,7 @@ namespace {
       (void) llvm::createLoopGuardWideningPass();
       (void) llvm::createIPConstantPropagationPass();
       (void) llvm::createIPSCCPPass();
+      (void) llvm::createIRCanonicalizerPass();
       (void) llvm::createInductiveRangeCheckEliminationPass();
       (void) llvm::createIndVarSimplifyPass();
       (void) llvm::createInstSimplifyLegacyPass();
 
@@ -46,6 +46,12 @@ extern char &LowerInvokePassID;
 FunctionPass *createInstructionNamerPass();
 extern char &InstructionNamerID;
 
+//===----------------------------------------------------------------------===//
+//
+// IRCanonicalizer - Transforms LLVM Modules into canonical form.
+//
+Pass *createIRCanonicalizerPass();
+
 //===----------------------------------------------------------------------===//
 //
 // LowerSwitch - This pass converts SwitchInst instructions into a sequence of
 
@@ -32,6 +32,7 @@ add_llvm_component_library(LLVMTransformUtils
   InjectTLIMappings.cpp
   InstructionNamer.cpp
   IntegerDivision.cpp
+  IRCanonicalizer.cpp
   LCSSA.cpp
   LibCallsShrinkWrap.cpp
   Local.cpp