diff --git a/lib/awful/tag.lua b/lib/awful/tag.lua
index 05da7c16..254c1001 100644
--- a/lib/awful/tag.lua
+++ b/lib/awful/tag.lua
@@ -155,7 +155,6 @@ end
 
 --- Swap 2 tags
 -- @function tag.swap
--- @see tag.swap
 -- @param tag2 The second tag
 -- @see client.swap
 function tag.object.swap(self, tag2)
diff --git a/lib/awful/wibar.lua b/lib/awful/wibar.lua
index 1df6fdbc..3ed9f0fa 100644
--- a/lib/awful/wibar.lua
+++ b/lib/awful/wibar.lua
@@ -262,7 +262,7 @@ end
 --
 -- @deprecated awful.wibox.stretch
 -- @see awful.placement
--- @see stretch
+-- @see awful.wibar.stretch
 
 --- Create a new wibox and attach it to a screen edge.
 -- You can add also position key with value top, bottom, left or right.