diff --git a/llvm/docs/ReleaseNotes.html b/llvm/docs/ReleaseNotes.html
index 4f14ac65ce24..1692003a4c32 100644
--- a/llvm/docs/ReleaseNotes.html
+++ b/llvm/docs/ReleaseNotes.html
@@ -340,6 +340,11 @@ expose new optimization opportunities:</p>
 <li>
   VISIBILITY_HIDDEN is gone.
 </li>
+<li>
+  The <tt>RegisterPass</tt> and <tt>RegisterAnalysisGroup</tt> templates are
+  considered deprecated, but continue to function in LLVM 2.8.  Clients are  
+  strongly advised to use the upcoming <tt>INITIALIZE_PASS()</tt> and
+  <tt>INITIALIZE_AG_PASS()</tt> macros instead.
 <li>
   SMDiagnostic takes different parameters now. //FIXME: how to upgrade?
 </li>