--- a/doc/book/README	Wed Sep 22 13:21:34 2010 +0200
+++ b/doc/book/README	Wed Sep 22 13:15:14 2010 +0200
@@ -46,6 +46,20 @@
 .. [foot note] the foot note content
 
 
+Boxes
+=====
+
+- warning box: 
+    .. warning::
+
+       Warning content
+- note box:
+    .. note::
+
+       Note content
+
+
+
 Cross references
 ================