diff --git a/lib/awful/button.lua.in b/lib/awful/button.lua.in
index 5e60f107..b92db916 100644
--- a/lib/awful/button.lua.in
+++ b/lib/awful/button.lua.in
@@ -25,7 +25,7 @@ ignore_modifiers = { "Lock", "Mod2" }
 -- ignored by default by this function), creatina button binding with this function
 -- will return 2 button objects: one with CapsLock on, and the other one with
 -- CapsLock off.
--- @see C api button() function for parameters.
+-- @see capi.button
 -- @return A table with one or several button objects.
 function new(mod, ...)
     local ret = {}
diff --git a/lib/awful/key.lua.in b/lib/awful/key.lua.in
index e0d777c6..a76e4f40 100644
--- a/lib/awful/key.lua.in
+++ b/lib/awful/key.lua.in
@@ -25,7 +25,7 @@ ignore_modifiers = { "Lock", "Mod2" }
 -- ignored by default by this function), creatina key binding with this function
 -- will return 2 key objects: one with CapsLock on, and the other one with
 -- CapsLock off.
--- @see C api key() function for parameters.
+-- @see capi.key
 -- @return A table with one or several key objects.
 function new(mod, ...)
     local ret = {}