[Checkins] SVN: grok/trunk/doc/groktut/ Update this based on assumptions of having installed grokproject

[Martijn Faassen]

Log message for revision 93908:
  Update this based on assumptions of having installed grokproject
  in the past and therefore having a shared eggs directory already.
  

Changed:
  U   grok/trunk/doc/groktut/INSTALL.txt
  U   grok/trunk/doc/groktut/buildout_tut.cfg

-=-
Modified: grok/trunk/doc/groktut/INSTALL.txt
===================================================================
--- grok/trunk/doc/groktut/INSTALL.txt	2008-12-11 15:49:52 UTC (rev 93907)
+++ grok/trunk/doc/groktut/INSTALL.txt	2008-12-11 15:57:17 UTC (rev 93908)
@@ -1,35 +1,34 @@
 Grok Tutorial Samples installation
 ----------------------------------
 
-The Grok tutorial samples make use of a system called buildout. First,
-we'll set up a buildout script that can be reused by all tutorials. Just
-type this in the ``groktut`` directory::
+To run the Grok tutorial samples we are going to assume you've already
+used an up to date version of grokproject to set up your buildout
+environment, including a shared eggs directory. If you haven't, the
+procedure below will try to download the required eggs over and over
+again, which is not very desirable.
 
-  $ python2.4 bootstrap.py
+One way to make the tutorials build quickly is to have a centrally
+installed version of buildout, for instance in your homedirectory's
+``bin`` directory. If so you can just change directory into the
+directories for each tutorial and run ``buildout -N`` there.
 
-This will download and install buildout. It will create various
-directories, only one of which, ``eggs``, is important. This directory
-contains all Python eggs shared by the tutorial samples.  If you
-already have a directory for sharing eggs with other buildouts, you
-can edit ``buildout_tut.cfg`` and change the ``eggs-directory`` option
-to point to this directory, e.g.::
+Alternatively we can install buildout here specifically for the
+tutorials. Just type this in the ``groktut`` directory::
 
-  [buildout]
-  eggs-directory = /home/me/shared-eggs
+  $ python2.4 bootstrap.py
 
-Now go to the tutorial sample you'd like to look at and launch
+This will download and install buildout in the ``groktut`` directory.
+
+Now you can go to the tutorial sample you'd like to look at and launch
 buildout::
 
   $ cd an_empty_grok_project
   $ ../buildout -N
 
-The -N option tells the buildout_ system not to look for newer files
-on the network. This greatly speeds up the buildout process if you
-have all required eggs already available, like the second time you run
-the buildout of a sample, as it skips network access.
+The ``-N`` option tells the buildout_ system not to look for newer
+files on the network. This greatly speeds up the buildout process if
+you have all required eggs already available.
 
-.. _buildout: http://cheeseshop.python.org/pypi/zc.buildout
-
 You will have a separate Zope instance created for you in each
 tutorial directory you run the buildout script. From the specific
 tutorial directory, you can start up Zope like this::

Modified: grok/trunk/doc/groktut/buildout_tut.cfg
===================================================================
--- grok/trunk/doc/groktut/buildout_tut.cfg	2008-12-11 15:49:52 UTC (rev 93907)
+++ grok/trunk/doc/groktut/buildout_tut.cfg	2008-12-11 15:57:17 UTC (rev 93908)
@@ -1,7 +1,5 @@
 [buildout]
 parts = data app zopectl test
-eggs-directory = ../eggs
-find-links = http://download.zope.org/distribution/
 
 [data]
 recipe = zc.recipe.filestorage