diff --git a/awesomerc.1.txt b/awesomerc.1.txt
index ce449f95..11509b4a 100644
--- a/awesomerc.1.txt
+++ b/awesomerc.1.txt
@@ -29,8 +29,8 @@ General
     Execute an external program.
 *exec* program::
     Replace awesome with another window manager (or itself; i.e. reload config).
-*statusbar_set_text*::
-    Set the statusbar text.
+*widget_tell* widget-identifier data::
+    Feed information to your widgets.
 
 Client
 ~~~~~~
@@ -104,6 +104,43 @@ FILES
 -----
 For an example of an awesomerc file, see the file provided with the sources
 
+EXAMPLES
+--------
+
+The general format of the awesomerc with some examples:
+
+....................
+screen 0    # particular settings for screen 0
+{           #
+  general   #
+  { }       # border=2 focus_move_pointer=true font="fixed-10" ...
+            #
+  colors    #
+  { }       # focus_bg="#000000" focus_border= ...
+            #
+  statusbar #
+  { }       # position="top" taglist tl {}  textbox tb {} ... 
+            # hint: tl is a identifier (you can freely choose)
+            # usage: awesome-client <<< "0 widget_tell tl some_data"
+            #
+  tags      #
+  { }       # tag identifier { layout="tile" wmfact=0.70 nmaster=2 }
+            #
+  layouts   #
+  { }       # layout max { symbol="[ ]" } (or tile, max, dwindle, floating, ...)
+}           #
+            #
+rules       #
+{ }         # rule { name="gimp" float=true tags="3" }
+            #
+mouse       #
+{ }         # tag { button="1" command="tag_view" }
+            #
+keys        #
+{ }         # key { modkey={"Mod4"} key="j" command="client_focusnext" }
+....................
+
+
 SEE ALSO
 --------
 awesome(1) awesome-client(1)
@@ -111,7 +148,7 @@ awesome(1) awesome-client(1)
 
 AUTHORS
 -------
-Julien Danjou <julien@danjou.info>
+This man page was written by Julien Danjou <julien@danjou.info> and Marco Candrian <mac@calmar.ws>.
 
 WWW
 ---