diff --git a/libkdecorations/kdecoration.h b/libkdecorations/kdecoration.h
index 614b90238a..7b1f3e0053 100644
--- a/libkdecorations/kdecoration.h
+++ b/libkdecorations/kdecoration.h
@@ -186,7 +186,7 @@ public:
     enum Ability {
         // announce
         AbilityAnnounceButtons = 0, ///< decoration supports AbilityButton* values (always use)
-        AbilityAnnounceColors = 1, ///< decoration supports AbilityColor* values (always use)
+        AbilityAnnounceColors = 1, ///< decoration supports AbilityColor* values (always use), @deprecated @todo remove KDE5
         // buttons
         AbilityButtonMenu = 1000,   ///< decoration supports the menu button
         AbilityButtonOnAllDesktops = 1001, ///< decoration supports the on all desktops button
@@ -200,15 +200,15 @@ public:
         AbilityButtonShade = 1009, ///< decoration supports a shade button
         AbilityButtonResize = 1010, ///< decoration supports a resize button
         // colors
-        AbilityColorTitleBack = 2000, ///< decoration supports titlebar background color
-        ABILITYCOLOR_FIRST = AbilityColorTitleBack, ///< @internal
-        AbilityColorTitleFore = 2001, ///< decoration supports titlebar foreground color
-        AbilityColorTitleBlend = 2002, ///< decoration supports second titlebar background color
-        AbilityColorFrame = 2010, ///< decoration supports frame color
-        AbilityColorHandle = 2011, ///< decoration supports resize handle color
-        AbilityColorButtonBack = 2020, ///< decoration supports button background color
-        AbilityColorButtonFore = 2021, ///< decoration supports button foreground color
-        ABILITYCOLOR_END, ///< @internal
+        AbilityColorTitleBack = 2000, ///< decoration supports titlebar background color, @deprecated @todo remove KDE5
+        ABILITYCOLOR_FIRST = AbilityColorTitleBack, ///< @internal, @deprecated @todo remove KDE5
+        AbilityColorTitleFore = 2001, ///< decoration supports titlebar foreground color, @deprecated @todo remove KDE5
+        AbilityColorTitleBlend = 2002, ///< decoration supports second titlebar background color, @deprecated @todo remove KDE5
+        AbilityColorFrame = 2010, ///< decoration supports frame color, @deprecated @todo remove KDE5
+        AbilityColorHandle = 2011, ///< decoration supports resize handle color, @deprecated @todo remove KDE5
+        AbilityColorButtonBack = 2020, ///< decoration supports button background color, @deprecated @todo remove KDE5
+        AbilityColorButtonFore = 2021, ///< decoration supports button foreground color, @deprecated @todo remove KDE5
+        ABILITYCOLOR_END, ///< @internal, @deprecated @todo remove KDE5
         // compositing
         AbilityProvidesShadow = 3000, ///< The decoration draws its own shadows.
         ///  @since 4.3
diff --git a/org.kde.KWin.xml b/org.kde.KWin.xml
index e8f4fb7eca..68053a8e52 100644
--- a/org.kde.KWin.xml
+++ b/org.kde.KWin.xml
@@ -68,6 +68,7 @@
     <method name="waitForCompositingSetup">
       <arg type="b" direction="out"/>
     </method>
+<!-- @deprecated, @todo remove KDE5     -->
     <method name="decorationSupportedColors">
       <arg type="ai" direction="out"/>
       <annotation name="com.trolltech.QtDBus.QtTypeName.Out0" value="QList&lt;int>"/>
diff --git a/workspace.h b/workspace.h
index 145e67082f..c4fd28195b 100644
--- a/workspace.h
+++ b/workspace.h
@@ -448,6 +448,10 @@ public:
     void cascadeDesktop();
     void unclutterDesktop();
     void doNotManage(const QString&);
+    /**
+     * @deprecated
+     * @todo: remove KDE5
+     **/
     QList<int> decorationSupportedColors() const;
     void nextDesktop();
     void previousDesktop();