diff --git a/lib/beautiful/init.lua b/lib/beautiful/init.lua
index bdc43f33f..ae1ef7734 100644
--- a/lib/beautiful/init.lua
+++ b/lib/beautiful/init.lua
@@ -75,15 +75,15 @@ local active_font
 --- The client border width.
 -- @beautiful beautiful.border_width
 
---- The default clients border width.
+--- The default clients border color.
 -- Note that only solid colors are supported.
 -- @beautiful beautiful.border_normal
 
---- The focused client border width.
+--- The focused client border color.
 -- Note that only solid colors are supported.
 -- @beautiful beautiful.border_focus
 
---- The marked clients border width.
+--- The marked clients border color.
 -- Note that only solid colors are supported.
 -- @beautiful beautiful.border_marked