From e2c34fe2e8e44fb03cecd46cc7607d4539f59ded Mon Sep 17 00:00:00 2001
From: Chris McDonough <chrism@agendaless.com>
Date: Sat, 19 Sep 2009 19:55:20 +0000
Subject: - Added a tutorial which explains how to use ``repoze.session``  
 (ZODB-based sessions) in a ZODB-based repoze.bfg app.

---
 docs/tutorials/zeo/index.rst | 33 ++++++++++++++++++++-------------
 1 file changed, 20 insertions(+), 13 deletions(-)

(limited to 'docs/tutorials/zeo')

diff --git a/docs/tutorials/zeo/index.rst b/docs/tutorials/zeo/index.rst
index edf499c7f..36d681acb 100644
--- a/docs/tutorials/zeo/index.rst
+++ b/docs/tutorials/zeo/index.rst
@@ -62,6 +62,9 @@ Installing Dependencies
    of this tutorial, we'll assume that your "application" is actually
    just the result of the ``bfg_starter`` Paster template.
 
+Configuration
+-------------
+
 #. Edit your application's Paste ``.ini`` file.
 
    If you already have an ``app`` section in the ``.ini`` file named
@@ -179,6 +182,9 @@ Installing Dependencies
                root['myapp'] = MyModel()
                transaction.commit()
            return root['myapp']
+
+Running
+-------
     
 #.  Start the ZEO server in a terminal with the current directory set
     to the package directory:
@@ -193,17 +199,17 @@ Installing Dependencies
     .. code-block:: bash
        :linenos:
 
-      [chrism@snowpro myapp]$ ../bin/runzeo -C zeo.conf 
-      ------
-      2009-09-19T13:48:41 INFO ZEO.runzeo (9910) created PID file './zeo.pid'
-      ------
-      2009-09-19T13:48:41 INFO ZEO.runzeo (9910) opening storage '1' using BlobStorage
-      ------
-      2009-09-19T13:48:41 WARNING ZODB.FileStorage Ignoring index for ./myapp.db
-      ------
-      2009-09-19T13:48:41 INFO ZEO.StorageServer (9910) StorageServer created RW with storages: 1:RW:./myapp.db
-      ------
-      2009-09-19T13:48:41 INFO ZEO.zrpc (9910) listening on ./zeo.sock
+       [chrism@snowpro myapp]$ ../bin/runzeo -C zeo.conf 
+       ------
+       2009-09-19T13:48:41 INFO ZEO.runzeo (9910) created PID file './zeo.pid'
+       ------
+       2009-09-19T13:48:41 INFO ZEO.runzeo (9910) opening storage '1' using BlobStorage
+       ------
+       2009-09-19T13:48:41 WARNING ZODB.FileStorage Ignoring index for ./myapp.db
+       ------
+       2009-09-19T13:48:41 INFO ZEO.StorageServer (9910) StorageServer created RW with storages: 1:RW:./myapp.db
+       ------
+       2009-09-19T13:48:41 INFO ZEO.zrpc (9910) listening on ./zeo.sock
 
 #.  While the ZEO server is running, start the application server:
 
@@ -217,8 +223,9 @@ Installing Dependencies
 #.  The root object is now a "folderish" ZODB object.  Nothing else
     about the application has changed.  
 
-#.  You can manipulate the database directly by using the ``bfgshell``
-    command in a separate terminal window:
+#.  You can manipulate the database directly (even when the
+    application's HTTP server is running) by using the ``bfgshell``
+    command in a third terminal window:
 
     .. code-block:: bash
        :linenos:
-- 
cgit v1.2.3