diff --git a/build-utils/fake-lua-src.lua b/build-utils/fake-lua-src.lua
index 2c1561563..4b3f3351f 100755
--- a/build-utils/fake-lua-src.lua
+++ b/build-utils/fake-lua-src.lua
@@ -61,9 +61,9 @@ for i, line in ipairs(ilines) do
 end
 
 print("---------------------------------------------------------------------------")
-print("-- capi: awesome C API")
+print("--- capi: awesome C API")
 print("--")
-print("-- @author Julien Danjou <julien@danjou.info>")
+print("-- @author Julien Danjou &lt;julien@danjou.info&gt;")
 print("-- @copyright 2008 Julien Danjou")
 print("---------------------------------------------------------------------------")
 print("module(\"capi\")")
diff --git a/lib/awful.lua.in b/lib/awful.lua.in
index 626b6364a..0125f3f3f 100644
--- a/lib/awful.lua.in
+++ b/lib/awful.lua.in
@@ -1,7 +1,5 @@
 ---------------------------------------------------------------------------
--- awful: AWesome Functions very UsefuL
---
--- @author Julien Danjou <julien@danjou.info>
+-- @author Julien Danjou &lt;julien@danjou.info&gt;
 -- @copyright 2008 Julien Danjou
 ---------------------------------------------------------------------------
 
@@ -29,6 +27,7 @@ local capi =
     keygrabber = keygrabber
 }
 
+--- awful: AWesome Functions very UsefuL
 module("awful")
 
 -- The ObjectTable class
diff --git a/lib/tabulous.lua b/lib/tabulous.lua
index c6ea7aae6..417617b4c 100644
--- a/lib/tabulous.lua
+++ b/lib/tabulous.lua
@@ -1,8 +1,6 @@
 ---------------------------------------------------------------------------
--- tabulous: fabulous tabs for awesome
---
--- @author Lucas de Vries <lucasdevries@gmail.com>
--- @author Julien Danjou <julien@danjou.info>
+-- @author Lucas de Vries &lt;lucasdevries@gmail.com&gt;
+-- @author Julien Danjou &lt;julien@danjou.info&gt;
 -- @copyright 2008 Julien Danjou, Lucas de Vries
 ---------------------------------------------------------------------------
 
@@ -12,6 +10,7 @@ local table = table
 local pairs = pairs
 local awful = require('awful')
 
+--- tabulous: fabulous tabs for awesome
 module("tabulous")
 
 local tabbed = {}