diff --git a/lib/naughty/notification.lua b/lib/naughty/notification.lua
index e9fb8d6c9..dbdb94294 100644
--- a/lib/naughty/notification.lua
+++ b/lib/naughty/notification.lua
@@ -214,12 +214,20 @@ local notification = {}
 -- @see shape
 
 --- Function to run on left click.
--- @property run
+--
+-- Use the signals rather than this.
+--
+-- @deprecatedproperty run
 -- @param function
+-- @see destroyed
 
 --- Function to run when notification is destroyed.
--- @property destroy
+--
+-- Use the signals rather than this.
+--
+-- @deprecatedproperty destroy
 -- @param function
+-- @see destroyed
 
 --- Table with any of the above parameters.
 -- args will override ones defined