--- a/doc/book/en/B0012-schema-definition.en.txt	Thu Mar 26 11:43:06 2009 +0100
+++ b/doc/book/en/B0012-schema-definition.en.txt	Thu Mar 26 11:56:08 2009 +0100
@@ -377,7 +377,11 @@
 Updating your application with your new schema
 ``````````````````````````````````````````````
 
-You have to get a shell on your application ::
+If you modified your schema, the update is not automatic; this is 
+indeed in general not a good idea.
+Instead, we call a shell on  your application, which is a 
+an interactive python shell, with an appropriate
+cubicweb environment ::
 
    cubicweb-ctl shell myinstance