--- a/doc/book/en/development/cubes/cc-newcube.rst	Thu Jul 02 22:01:19 2009 +0200
+++ b/doc/book/en/development/cubes/cc-newcube.rst	Mon Jul 06 14:13:49 2009 +0200
@@ -13,16 +13,15 @@
   hg add .
   hg ci
 
-If all went well, you should see the cube you just create in the list
-returned by `cubicweb-ctl list` in the section *Available components*,
+If all went well, you should see the cube you just created in the list
+returned by ``cubicweb-ctl list`` in the section *Available components*,
 and if it is not the case please refer to :ref:`ConfigurationEnv`.
 
-To use a cube, you have to list it in the variable ``__use__``
-of the file ``__pkginfo__.py`` of the instance.
-This variable is used for the instance packaging (dependencies
-handled by system utility tools such as APT) and the usable cubes
-at the time the base is created (import_erschema('MyCube') will
-not properly work otherwise).
+To reuse an existing cube, add it to the list named ``__use__`` and defined in
+:file:`__pkginfo__.py`.  This variable is used for the instance packaging
+(dependencies handled by system utility tools such as APT) and the usable cubes
+at the time the base is created (import_erschema('MyCube') will not properly
+work otherwise).
 
 .. note::
     Please note that if you do not wish to use default directory

--- a/doc/book/en/intro/tutorial/components.rst	Thu Jul 02 22:01:19 2009 +0200
+++ b/doc/book/en/intro/tutorial/components.rst	Mon Jul 06 14:13:49 2009 +0200
@@ -23,6 +23,8 @@
 
 * classtags: Tag (to tag anything)
 
+* comment: Comment (to attach comment threads to entities)
+
 * file: File (to allow users to upload and store binary or text files)
 
 * link: Link (to collect links to web resources)
@@ -37,10 +39,6 @@
 * zone: Zone (to define places within larger places, for example a
   city in a state in a country)
 
-The available system entities are:
-
-* comment: Comment (to attach comment threads to entities)
-
 
 Adding comments to BlogDemo
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~