diff -r 6231a61dabfa -r 73a352526577 doc/book/en/B1021-views-stdlib.en.txt
--- a/doc/book/en/B1021-views-stdlib.en.txt	Mon Dec 29 15:37:12 2008 -0800
+++ b/doc/book/en/B1021-views-stdlib.en.txt	Mon Dec 29 17:47:00 2008 -0800
@@ -7,59 +7,83 @@
 to one or more entities. Their identifier is what distinguish them from
 each others and the main ones are:
 
-:primary:
-    primary view of an entity, this is the view called by default when a single
-    entity is in the result set and needs to be displayed. This view is supposed
-    to render a maximum of informations about the entity.
-:secondary:
-    secondary view of an entity. By default it renders the two first attributes
-     of the entity as a clickable link redirecting to the primary view.
-:oneline:
-    similar to the `secondary` view, but called when we want the view to stand
-    on a single line, or just get a brief view. By default this view uses the
+*primary*
+    Primary view of an entity, this is the view called by default when a single
+    non final entity is in the result set and needs to be displayed. 
+    This view is supposed to render a maximum of informations about the entity.
+
+*text*
+    This is the simplest text view for an entity. It displays the 
+    title of an entity. It should not contain HTML.
+
+*oneline*
+    This is a hyper linked *text* view. Similar to the `secondary` view, 
+    but called when we want the view to stand on a single line, or just 
+    get a brief view. By default this view uses the
     parameter `MAX_LINE_CHAR` to control the result size.
-:text:
-    similar to the `oneline` view, but should not contain HTML.
-:incontext, outofcontext:
-    similar to the `secondary` view, but called when an entity is considered
+
+*secondary*
+    This is a combinaison of an icon and a *oneline* view.
+    By default it renders the two first attributes of the entity as a 
+    clickable link redirecting to the primary view.
+
+*incontext, outofcontext*
+    Similar to the `secondary` view, but called when an entity is considered
     as in or out of context. By default it respectively returns the result of 
     `textincontext` and `textoutofcontext` wrapped in a link leading to 
     the primary view of the entity.
-:textincontext, textoutofcontext:
-    similar to the `text` view, but called is an entity is considered out or
+
+*textincontext, textoutofcontext*
+    Similar to the `text` view, but called when an entity is considered out or
     in context. By default it returns respectively the result of the 
     methods `.dc_title` and `.dc_long_title` of the entity.
-:list:
-    creates a HTML list (`<ul>`) and call the view `listitem` for each entity
-    of the result set
-:listitem:
-    redirects by default to the `outofcontext` view
-:rss:
-    creates a RSS/XML view and call the view `rssitem` for each entity of
-    the result set
-:rssitem:
-    create a RSS/XML view for each entity based on the results of the dunblin core
+
+*list*
+    This view displays a list of entities by creating a HTML list (`<ul>`) 
+    and call the view `listitem` for each entity of the result set.
+
+*listitem*
+    This view redirects by default to the `outofcontext` view.
+
+*rss*
+    Creates a RSS/XML view and call the view `rssitem` for each entity of
+    the result set.
+
+*rssitem*
+    Create a RSS/XML view for each entity based on the results of the dublin core
     methods of the entity (`dc_*`)
 
+*sidebox*
+  This view displays usually a side box of some related entities 
+  in a primary view.
+
 Start view:
 
-:index:
-    home page
-:schema:
-    display the schema of the application
+*index*
+    This view defines the home page of your application. It does not require
+    a result set to apply to.
+
+*schema*
+    A view dedicated to the display of the schema of the application
 
 Special views:
 
-:noresult:
-    called if the result set is empty
-:finall:
-    display the value of a cell without trasnformation (in case of a non final
+*noresult*
+    This view is the default view used when no result has been found
+    (e.g. empty result set).
+
+*final*
+    Display the value of a cell without trasnformation (in case of a non final
     entity, we see the eid). Applicable on any result set.
-:table:
-    creates a HTML table (`<table>`) and call the view `cell` for each cell of
+
+*table*
+    Creates a HTML table (`<table>`) and call the view `cell` for each cell of
     the result set. Applicable on any result set.
-:cell:
-    by default redirects to the `final` view if this is a final entity or
+
+*cell*
+    By default redirects to the `final` view if this is a final entity or
     `outofcontext` view otherwise
-:null:
-    view always applicable and which does not return anything
+
+*null*
+    This view is the default view used when nothing needs to be rendered.
+    It is always applicable and it does not return anything