diff --git a/docs/common/widget.ldoc b/docs/common/widget.ldoc
index 2587c0420..36e994d5f 100644
--- a/docs/common/widget.ldoc
+++ b/docs/common/widget.ldoc
@@ -88,6 +88,7 @@
 
 --- When a mouse button is pressed over the widget.
 -- @signal button::press
+-- @tparam table self The current object instance itself.
 -- @tparam number lx The horizontal position relative to the (0,0) position in
 -- the widget.
 -- @tparam number ly The vertical position relative to the (0,0) position in the
@@ -118,6 +119,7 @@
 
 --- When a mouse button is released over the widget.
 -- @signal button::release
+-- @tparam table self The current object instance itself.
 -- @tparam number lx The horizontal position relative to the (0,0) position in
 -- the widget.
 -- @tparam number ly The vertical position relative to the (0,0) position in the
@@ -148,6 +150,7 @@
 
 --- When the mouse enter a widget.
 -- @signal mouse::enter
+-- @tparam table self The current object instance itself.
 -- @tparam table find_widgets_result The entry from the result of
 -- @{wibox.drawable:find_widgets} for the position that the mouse hit.
 -- @tparam wibox.drawable find_widgets_result.drawable The drawable containing
@@ -172,6 +175,7 @@
 
 --- When the mouse leave a widget.
 -- @signal mouse::leave
+-- @tparam table self The current object instance itself.
 -- @tparam table find_widgets_result The entry from the result of
 -- @{wibox.drawable:find_widgets} for the position that the mouse hit.
 -- @tparam wibox.drawable find_widgets_result.drawable The drawable containing