diff --git a/lib/awful/menu.lua.in b/lib/awful/menu.lua.in
index dc337870b..b7112dd2a 100644
--- a/lib/awful/menu.lua.in
+++ b/lib/awful/menu.lua.in
@@ -390,7 +390,12 @@ function toggle(menu, args)
 end
 
 --- Open a menu popup.
--- @param menu Table containing the menu informations. Key items: Table containing the displayed items, each element is a tab containing: item name, triggered action, submenu table or function, item icon (optional). Keys [fg|bg]_[focus|normal], border, border_width, submenu_icon, height and width override the default display for your menu, each of them are optional. Key auto_expand controls the submenu auto expand behaviour by setting it to true (default) or false.
+-- @param menu Table containing the menu informations.<br/>
+-- <ul>
+-- <li> Key items: Table containing the displayed items, each element is a tab containing: item name, triggered action, submenu table or function, item icon (optional). </li>
+-- <li> Keys [fg|bg]_[focus|normal], border, border_width, submenu_icon, height and width override the default display for your menu, each of them are optional. </li>
+-- <li> Key auto_expand controls the submenu auto expand behaviour by setting it to true (default) or false. </li>
+-- </ul>
 -- @param parent Specify the parent menu if we want to open a submenu, this value should never be set by the user.
 -- @param num Specify the parent's clicked item number if we want to open a submenu, this value should never be set by the user.
 function new(menu, parent, num)