--- a/doc/book/README	Wed Feb 03 18:44:24 2010 +0100
+++ b/doc/book/README	Wed Feb 03 18:44:50 2010 +0100
@@ -9,6 +9,8 @@
 Chapter
 =======
 
+.. _Level1AnchorForLaterReference:
+
 Level 1 section
 ---------------
 
@@ -24,20 +26,29 @@
 
 
 inline directives:
-  :file:
-  :envvar:
-  :command:
+  :file:`directory/file`
+  :envvar:`AN_ENV_VARIABLE`
+  :command:`command --option arguments`
 
   :ref:, :mod:
 
 
-XXX
-* lien vers cw.cwconfig.CW_CUBES_PATH par ex.
-
-
 .. sourcecode:: python
 
    class SomePythonCode:
      ...
 
-.. XXX a comment
+.. XXX a comment, wont be rendered
+
+
+a [foot note]_
+
+.. [foot note] the foot note content
+
+
+
+XXX
+* lien vers cw.cwconfig.CW_CUBES_PATH par ex.
+
+
+automodule, autofunction, automethod, autofunction