diff --git a/lib/awful/layout/suit/init.lua.in b/lib/awful/layout/suit/init.lua.in
index c5660521c..a940ca090 100644
--- a/lib/awful/layout/suit/init.lua.in
+++ b/lib/awful/layout/suit/init.lua.in
@@ -1,3 +1,9 @@
+---------------------------------------------------------------------------
+-- @author Julien Danjou <julien@danjou.info>
+-- @copyright 2008 Julien Danjou
+-- @release @AWESOME_VERSION@
+---------------------------------------------------------------------------
+
 --- Suits for awful
 
 return
diff --git a/lib/awful/widget/common.lua.in b/lib/awful/widget/common.lua.in
index cc38d6c21..f1947162b 100644
--- a/lib/awful/widget/common.lua.in
+++ b/lib/awful/widget/common.lua.in
@@ -17,6 +17,7 @@ local wibox = require("wibox")
 local imagebox = require("wibox.widget.imagebox")
 local textbox = require("wibox.widget.textbox")
 
+--- Common utilities for awful widgets
 local common = {}
 
 -- Recursively processes a template, replacing the tables representing the icon and
diff --git a/lib/gears/init.lua.in b/lib/gears/init.lua.in
index 94c31f66b..fa2b15e10 100644
--- a/lib/gears/init.lua.in
+++ b/lib/gears/init.lua.in
@@ -4,7 +4,7 @@
 -- @release @AWESOME_VERSION@
 ---------------------------------------------------------------------------
 
--- gears
+--- gears
 
 return
 {
diff --git a/lib/wibox/layout/init.lua.in b/lib/wibox/layout/init.lua.in
index d50a5ba60..12d78b691 100644
--- a/lib/wibox/layout/init.lua.in
+++ b/lib/wibox/layout/init.lua.in
@@ -4,6 +4,7 @@
 -- @release @AWESOME_VERSION@
 ---------------------------------------------------------------------------
 
+--- Collection of layouts that can be used in widget boxes
 -- wibox.layout
 
 return
diff --git a/lib/wibox/widget/init.lua.in b/lib/wibox/widget/init.lua.in
index 39d7082d1..aedd5a19e 100644
--- a/lib/wibox/widget/init.lua.in
+++ b/lib/wibox/widget/init.lua.in
@@ -4,7 +4,7 @@
 -- @release @AWESOME_VERSION@
 ---------------------------------------------------------------------------
 
--- wibox.widget
+--- wibox.widget
 
 return
 {
diff --git a/lib/wibox/widget/systray.lua.in b/lib/wibox/widget/systray.lua.in
index e3d685b1b..16a9fb918 100644
--- a/lib/wibox/widget/systray.lua.in
+++ b/lib/wibox/widget/systray.lua.in
@@ -11,7 +11,7 @@ local capi = { awesome = awesome }
 local setmetatable = setmetatable
 local error = error
 
--- wibox.widget.systray
+--- wibox.widget.systray
 local systray = { mt = {} }
 
 local created_systray = false