diff --git a/applet.h b/applet.h
index 9f7858d50..4b6a5c255 100644
--- a/applet.h
+++ b/applet.h
@@ -734,6 +734,12 @@ class PLASMA_EXPORT Applet : public QGraphicsWidget
 
         /**
          * Emitted when the user clicked on a button of the message overlay
+         *
+         * Since the signal passes the type MessageButton without specifying
+         * the Plasma namespace and since automoc is pedantic if you want to
+         * use this signal outside the Plasma namespace you have to declare
+         * "typedef Plasma::MessageButton MessageButton" and use the typedef
+         * in your slot and in the connect.
          * @see showMessage
          * @see Plasma::MessageButton
          * @since 4.3
@@ -760,7 +766,7 @@ class PLASMA_EXPORT Applet : public QGraphicsWidget
          * Emitted when the immutability changes
          * @since 4.4
          */
-        void immutabilityChanged(ImmutabilityType immutable);
+        void immutabilityChanged(Plasma::ImmutabilityType immutable);
 
     public Q_SLOTS:
         /**