# HG changeset patch
# User Aurelien Campeas <aurelien.campeas@logilab.fr>
# Date 1280913799 -7200
# Node ID eae118a84cc696cf0faee76760e526fd5a4285d7
# Parent  2a164fabcbfc6944ef00a49c43a511c6b76ada92
[doc/book] note about bootstrap_cubes file

diff -r 2a164fabcbfc -r eae118a84cc6 doc/book/en/devrepo/testing.rst
--- a/doc/book/en/devrepo/testing.rst	Wed Aug 04 10:55:32 2010 +0200
+++ b/doc/book/en/devrepo/testing.rst	Wed Aug 04 11:23:19 2010 +0200
@@ -145,7 +145,7 @@
    connection from another !
 
 Email notifications tests
--------------------------
+`````````````````````````
 
 When running tests potentially generated e-mails are not really sent
 but is found in the list `MAILBOX` of module
@@ -212,6 +212,21 @@
   auto_populate cannot guess by itself; these must yield resultsets
   against which views may be selected.
 
+Testing with other cubes
+------------------------
+
+Sometimes a small component cannot be tested all by itself, so one
+needs to specify other cubes to be used as part of the the unit test
+suite. This is handled by the ``bootstrap_cubes`` file located under
+``mycube\test\data``. One example from the `preview` cube::
+
+ card, file, preview
+
+The format is:
+
+* possibly several empy lines or lines starting with ``#`` (comment lines)
+* one line containing a coma separated list of cube names.
+
 
 Test APIS
 ---------