diff --git a/lib/awful/layout/init.lua b/lib/awful/layout/init.lua
index df99b1b06..114b12b3e 100644
--- a/lib/awful/layout/init.lua
+++ b/lib/awful/layout/init.lua
@@ -246,8 +246,8 @@ capi.client.connect_signal("list", function()
                                    end
                                end)
 
---- Default handler for tiled clients request::geometry with the `mouse.move`
--- context.
+--- Default handler for `request::geometry` signals for tiled clients with
+-- the "mouse.move" context.
 -- @tparam client c The client
 -- @tparam string context The context
 -- @tparam table hints Additional hints
diff --git a/lib/awful/mouse/init.lua b/lib/awful/mouse/init.lua
index 13cd23ae9..1f94adea6 100644
--- a/lib/awful/mouse/init.lua
+++ b/lib/awful/mouse/init.lua
@@ -222,7 +222,7 @@ function mouse.client.resize(c, corner, args)
     return corner
 end
 
---- Default handler for `request::geometry` signals with `mouse.resize` context.
+--- Default handler for `request::geometry` signals with "mouse.resize" context.
 -- @signalhandler awful.mouse.resize_handler
 -- @tparam client c The client
 -- @tparam string context The context