diff --git a/lib/beautiful.lua.in b/lib/beautiful.lua.in
index 7cecfdeb..5e54a70f 100644
--- a/lib/beautiful.lua.in
+++ b/lib/beautiful.lua.in
@@ -74,8 +74,9 @@ function beautiful.get_font_height(name)
 end
 
 --- Init function, should be runned at the beginning of configuration file.
--- @param config The theme to load. It can be either the path to the theme file
--- (returning a table) or directly the table containing all the theme values
+-- @tparam string|table config The theme to load. It can be either the path to
+--                      the theme file (returning a table) or directly the table
+--                      containing all the theme values.
 function beautiful.init(config)
     if config then
         local success
@@ -113,7 +114,8 @@ function beautiful.init(config)
 end
 
 --- Get the current theme.
--- @return The current theme table.
+--
+-- @treturn table The current theme table.
 function beautiful.get()
     return theme
 end