diff --git a/awesome.1.txt b/awesome.1.txt
index 7d106a9e1..5e305f173 100644
--- a/awesome.1.txt
+++ b/awesome.1.txt
@@ -29,15 +29,8 @@ former or as a rectangular fractal for the later.
 Windows are grouped by tags. Each window can be tagged with one or multiple
 tags. Selecting certain tags displays all windows with these tags.
 
-awesome contains a small status bar which displays all available tags, the layout,
-the title of the focused window, and a status text. A
-floating window is indicated with an empty circle and a maximized
-floating window is indicated with a circle square before the windows
-title. The selected tags are indicated with a different color. The tags of
-the focused window are indicated with a filled square in the top left
-corner. The tags which are applied to one or more windows are indicated
-with an empty square in the top left corner.
-awesome can draw a small border around windows to indicate the focus state.
+awesome can contain small statusbars which can display anything you want:
+all available tags, the layout, the title of the visible windows, a text, etc.
 
 OPTIONS
 -------
@@ -53,7 +46,7 @@ DEFAULTS MOUSE BINDINGS
 *Button1* on tag name::
     View tag.
 *Mod4 + Button1* on tag name::
-    Tag current client with this tag.
+    Tag current client with this tag only.
 *Button3* on tag name::
     Add this tag to current view.
 *Mod4 + Button3* on tag name::
@@ -101,8 +94,6 @@ DEFAULTS KEY BINDINGS
     Increase number of columns for non-master windows by 1.
 *Mod4 \+ Control \+ l*::
     Decrease number of columns for non-master windows by 1.
-*Mod4 + Escape*::
-    View previously selected tag.
 *Mod4 + Left*::
     View previous tag.
 *Mod4 + Right*::
@@ -145,7 +136,7 @@ backend instead): AWT_TOOLKIT=MToolkit
 
 AUTHORS
 -------
-Julien Danjou <julien@danjou.info>
+Julien Danjou <julien@danjou.info> and others.
 
 WWW
 ---
diff --git a/awesomerc.5.txt b/awesomerc.5.txt
index 73a1e6691..f2500ed2c 100644
--- a/awesomerc.5.txt
+++ b/awesomerc.5.txt
@@ -36,6 +36,112 @@ By using hexadecimal format, you can also specifies an alpha channel:
 that means that #00ff00 will draw pure green, but #00ff00aa will set the
 alpha channel to `aa' and will blend the green with the color under it.
 
+WIDGETS
+-------
+The current list of available widget is:
+
+- iconbox
+- graph
+- progressbar
+- taglist
+- tasklist
+- textbox
+
+Each widget as its own set of properties, described below, that can bet modified with the set()
+method.
+
+ICONBOX
+~~~~~~~
+*image*::
+    The image path.
+
+*resize*::
+    True if you want the image to be auto-resized.
+
+PROGRESSBAR
+~~~~~~~~~~~
+A progressbar widget can contain several bars, so some properties need a data section,
+that means a title for the bar. For example, if you want to feed data to the `memory' bar
+you want to do mywidget:set("data", "memory 100"), where memory will be the data section.
+Using a new data section name will automagically create a new bar.
+
+
+The following properties require a data section before the value:
+
+*data*::
+    Feed with data.
+
+*fg*::
+    Foreground color.
+
+*fg_off*::
+    Unknown.
+
+*bg*::
+    Background color.
+
+*bordercolor*::
+    Border color.
+
+*fg_center*::
+    Foreground center color.
+
+*fg_end*::
+    Foreground end color.
+
+*min_value*::
+    Minimum value.
+
+*max_value*::
+    Maximum value.
+
+*reverse*::
+    True to draw reverse.
+
+
+The following properties do not require a data section before the value and applies to all bars inside
+the widget:
+
+*gap*::
+    Gap between borders.
+
+*ticks_count*::
+    The number of ticks.
+
+*ticks_gap*::
+    The gap between ticks.
+
+*border_padding*::
+    The padding inside the border.
+
+*border_width*::
+    The border width.
+
+*width*::
+    The widget width.
+
+*height*::
+    The widget height.
+
+*vertical*::
+    True if the widget is vertical.
+
+GRAPH
+~~~~~
+No documentation yet.
+
+TAGLIST
+~~~~~~~
+No documentation yet.
+
+TASKLIST
+~~~~~~~~
+No documentation yet.
+
+TEXTBOX
+~~~~~~~
+No documentation yet.
+
 SEE ALSO
 --------
 awesome(1) awesome-client(1)