[Checkins] SVN: grok/trunk/ add details on upgrading to the new paster based layout

[Michael Haubenwallner]

Log message for revision 101468:
  add details on upgrading to the new paster based layout

Changed:
  U   grok/trunk/CHANGES.txt
  U   grok/trunk/doc/upgrade.txt

-=-
Modified: grok/trunk/CHANGES.txt
===================================================================
--- grok/trunk/CHANGES.txt	2009-07-03 16:02:00 UTC (rev 101467)
+++ grok/trunk/CHANGES.txt	2009-07-04 06:13:52 UTC (rev 101468)
@@ -13,7 +13,7 @@
 * updated zope.publisher dependency to 3.4.8 (fix paster.httpserver
   related bugs in XMLRPC, PUT)
 
-* switched buildout to paster base template (like grokproject default)
+* switched buildout to paster based template (like grokproject default)
   https://bugs.launchpad.net/grok/+bug/307197
 
 * changed interpreter name from 'python' to 'grokpy'

Modified: grok/trunk/doc/upgrade.txt
===================================================================
--- grok/trunk/doc/upgrade.txt	2009-07-03 16:02:00 UTC (rev 101467)
+++ grok/trunk/doc/upgrade.txt	2009-07-04 06:13:52 UTC (rev 101468)
@@ -16,8 +16,33 @@
       <grant permission="grok.View"
              principal="zope.Anybody" />
 
-  IF YOU DO NOT MAKE THIS CHANGE, ALL OF YOUR VIEWS WILL BE UNAVAILBLE FOR ANONYMOUS.
+  IF YOU DO NOT MAKE THIS CHANGE, ALL OF YOUR VIEWS WILL BE UNAVAILBLE FOR
+  ANONYMOUS.
 
+* Grok buildout now creates a paster based project, as grokproject
+  does for some time. It should be possible to update your checkout and
+  run buildout again to switch to the new layout.
+
+* Be careful with the files in 'parts/app' and 'parts/zopectl', esp.
+  'parts/zopectl/access.log' as both folders are deleted.
+
+* Logfiles are now in 'parts/log', config files are now in 'parts/etc'.
+  Both access and event logs are file-based.
+  Find more information on configuration and settings in 'etc/README.txt'.
+
+* Start the instance now like:
+    'bin/paster serve parts/etc/deploy.ini'
+  or
+    'bin/projectname-ctl fg'
+
+  If you start your instance with 'debug.ini' first point your browser to
+    'http://localhost:8080/@@login.html' and authenticate. This will ev.
+  be removed in a later release.
+
+* Interpreter name has been changed from 'bin/python' to 'bin/grokpy' to
+  avoid conflicts with 'virtualenv'.
+
+
 Upgrading to 1.0a1
 ------------------