Added a test debug recipe to make writing tests a little easier.

(Also stop writing doc.txt. --long-description is better. And
rearranged setup.py a little.)

setup.py

@@ -11,7 +11,7 @@
 # FOR A PARTICULAR PURPOSE.
 #
 ##############################################################################
-
+name = "zc.buildout"
 version = "1.4.0dev"
 
 import os
@@ -54,9 +54,15 @@ long_description=(
         '**********************\n'
         )
 
-open('doc.txt', 'w').write(long_description)
+entry_points = """
+[console_scripts]
+buildout = %(name)s.buildout:main
+
+[zc.buildout]
+debug = %(name)s.testrecipes:Debug
+
+""" % dict(name=name)
 
-name = "zc.buildout"
 setup(
     name = name,
     version = version,
@@ -74,8 +80,7 @@ setup(
     namespace_packages = ['zc'],
     install_requires = 'setuptools',
     include_package_data = True,
-    entry_points = {'console_scripts':
-                    ['buildout = %s.buildout:main' % name]}, 
+    entry_points = entry_points,
     zip_safe=False,
     classifiers = [
        'Intended Audience :: Developers',

src/zc/buildout/testrecipes.py

+
+class Debug:
+
+    def __init__(self, buildout, name, options):
+        self.buildout = buildout
+        self.name = name
+        self.options = options
+
+    def install(self):
+        items = self.options.items()
+        items.sort()
+        for option, value in items:
+            print "  %s=%r" % (option, value)
+        return ()
+
+    update = install