[Checkins] SVN: zc.buildout/branches/help-api/src/zc/buildout/tests.py more explanation on the purpose of the tests

[Tarek Ziade]

Log message for revision 83123:
  more explanation on the purpose of the tests

Changed:
  U   zc.buildout/branches/help-api/src/zc/buildout/tests.py

-=-
Modified: zc.buildout/branches/help-api/src/zc/buildout/tests.py
===================================================================
--- zc.buildout/branches/help-api/src/zc/buildout/tests.py	2008-01-23 20:41:52 UTC (rev 83122)
+++ zc.buildout/branches/help-api/src/zc/buildout/tests.py	2008-01-23 20:58:01 UTC (rev 83123)
@@ -635,8 +635,8 @@
 
 def test_describe():
     """
-    If help is followed by recipe names, it shows the 
-    recipe's class docstring.
+    The describe command shows an arbitrary 
+    recipe's class docstring used in the buildout.
   
     Let's call describe for zc.recipe.egg:
 
@@ -775,6 +775,10 @@
 
 def test_describe_versions():
     """
+    Sometimes a recipe comes in two version in a buildout
+    environment. Let's make sure the describe command
+    handles this correctly.
+
     Now let's create our own recipe:
     
     >>> mkdir('myrecipes')