diff --git a/doc/org.eclipse.cdt.doc.isv/guide/deprecated_API_removals.html b/doc/org.eclipse.cdt.doc.isv/guide/deprecated_API_removals.html
index 5ca7c9f71f8..0cc11223002 100644
--- a/doc/org.eclipse.cdt.doc.isv/guide/deprecated_API_removals.html
+++ b/doc/org.eclipse.cdt.doc.isv/guide/deprecated_API_removals.html
@@ -43,6 +43,7 @@
DSF and DSF-GDB API Changes.
Partial removal of CDT 3.X project support.
Removal of CDT Core Options API.
+ TM Terminal has major changes to support new color and preference functionality.
Planned Removals after June 2022
@@ -228,6 +229,34 @@
See Bug 565154.
+
+
+ The TM Terminal's control (org.eclipse.tm.terminal.control) bundle has a major new version to support numerous API
+ changes to support features such as new colors, preference sharing and some other code clean-up.
+
+
+ - org.eclipse.tm.terminal.model.Style removed and is mostly replaced by
+ org.eclipse.tm.terminal.model.TerminalStyle. To handle
+ new API and color handling, the entire Style class was replaced with TerminalStyle that operates in a similar way.
+ Because some methods in TerminalStyle have similar signatures to those in removed Style class a new class was
+ introduced to prevent accidental use of incorrect API. See Bug 562495.
+ - org.eclipse.tm.terminal.model.StyleColor removed. Replaced by a new way of representing standard color in the
+ terminal using the new enum org.eclipse.tm.terminal.model.TerminalColor.. See Bug 562495.
+
+ - org.eclipse.tm.terminal.model.ITerminalTextData method taking or returning Style now use TerminalStyle. See Bug 562495.
+
+ - org.eclipse.tm.terminal.model.ITerminalTextDataReadOnly method taking or returning Style now use TerminalStyle.
+ See Bug 562495.
+
+ - org.eclipse.tm.terminal.model.LineSegment method taking or returning Style now use TerminalStyle. See Bug 562495.
+
+
+
+
Future Deletions
@@ -289,4 +318,4 @@