[Checkins] SVN: zc.buildout/branches/gary-4/CHANGES.txt clarify CHANGES text

[Gary Poster]

Log message for revision 108787:
  clarify CHANGES text

Changed:
  U   zc.buildout/branches/gary-4/CHANGES.txt

-=-
Modified: zc.buildout/branches/gary-4/CHANGES.txt
===================================================================
--- zc.buildout/branches/gary-4/CHANGES.txt	2010-02-05 13:36:16 UTC (rev 108786)
+++ zc.buildout/branches/gary-4/CHANGES.txt	2010-02-05 14:15:57 UTC (rev 108787)
@@ -6,7 +6,7 @@
 
 New Features:
 
-- Buildout can be safely used with a system Python.  Note that the Python is
+- Buildout can be safely used with a system Python.  Note that Python is
   always used, by default, with -S: that is, site-packages are not
   included. If you would like to have access to your site-packages, see
   the next bullet point.
@@ -18,13 +18,22 @@
   Python's site-packages has the same exact version as specified in your
   buildout configuration, buildout will still use its own copy.
 
-- Added new function to generate scripts and interpreter.  It produces
-  a full-featured interpreter (all command-line options supported) and the
-  ability to safely let scripts include site packages (see
-  z3c.recipe.scripts).  In this case a functioning site.py also is available
-  (and namespace packages are handled somewhat more efficiently than standard
-  pkg_resources usage).
+- Added new function, ``zc.buildout.easy_install.generate_scripts``, to
+  generate scripts and interpreter.  It produces a full-featured
+  interpreter (all command-line options supported) and the ability to
+  safely let scripts include site packages.  A safe and functional
+  site.py also is available, which will make it safer for use with a
+  system Python than the pre-existing buildout function
+  (``zc.buildout.easy_install.scripts``) and recipe (``zc.recipe.egg``).
 
+  End users should see z3c.recipe.scripts, which provides this
+  functionality within buildout configuration files.
+
+  The older function (``zc.buildout.easy_install.scripts``) and recipe
+  (``zc.recipe.egg``) still survive, because of their comparative attractive
+  simplicity, because they still work well when a non-system Python is used,
+  and because they can often be used well with a system Python.
+
 - Improve bootstrap.
 
   * New options let you specify where to find ez_setup.py and where to find