updated docs based on a1c1 feedback

doc/CHANGES.txt

@@ -32,6 +32,11 @@ Zope Changes
 
         o Simpler creation of Python products.
 
+    Unfortunately, there are a number of incompatabilities between
+    Zope and Python 1.5.2 that have been reported but not yet
+    fixed. Zope 2.0 alpha 2, which will be released the week of May
+    26, will fix most or all of these.
+
     ZODB 3
 
       ZODB is the next generation of our object database architecture.
@@ -73,6 +78,10 @@ Zope Changes
 
         - FileStorage packing isn't available yet,
 
+	- OPTIMIZATION: FileStorage will get a more efficient data
+          structure for maintaining index information and key methods
+          in the ZODB framework will move to C.
+
         - Tools to convert ZODB 2 databases to ZODB 3 File
           Storages or import files are needed.
 
@@ -97,6 +106,8 @@ Zope Changes
           This is only a problem when running Zope 2 with multiple
 	  threads.
 	
+	- The default content needs to be provided for the new
+          database format.
 
     ZClasses
 
@@ -140,9 +151,10 @@ Zope Changes
         candidate releases over the next several weeks.
 
         Early releases will support both the ZODB 2 (aka 
-        BoboPOS) and ZODB3.  We may even support ZODB 2 in Zope 2.0
+        BoboPOS) and ZODB 3.  We may even support ZODB 2 in Zope 2.0
         final, but ZODB 2 support will be phased out by Zope 2.1 or
-        sooner. 
+        sooner.  Some features (e.g. the new control panel version
+        manager) may require ZODB 3.
 
   Releases
 

doc/INSTALL.txt

@@ -44,9 +44,34 @@ Choosing your database
 
     - You can use ZODB 3 with the ZopeHTTPServer and the
       PCGI publisher by changing the published module to
-      Zope.  This will only use a single thread, however.
+      Zope. 
   )
 
+Quick Start
+
+  If you are impatient, the following commands should get you up and
+  running with Zope 2 using ZServer and ZODB 3 on Unix::
+
+    python wo_pcgi.py  # Note, this mst be Python 1.5.2
+    python z2.py -d <your dns server>
+
+  where you need to supply the IP address of your dns server to the -d
+  option.  If you get errors indicating that addresses are in use,
+  then you will have to supply arguments to z2.py to change the ports
+  used for HTTP or FTP. (See the help for the z2.py script by
+  running z2.py with the -h option.)
+
+  You can then connect to Zope 2 by directing your browser to::
+
+     http://yourhost:9673/manage
+
+  where yourhost is the name or address of the machine running Zope 2.
+  If you changed the HTTP port with the -w option to z2.py, then use
+  it rather than 9673.  
+
+  You will be prompted for a user name and password, which may
+  be found in the 'access' file in the Zope installation directory.
+
 Building Zope
   
   There are some python scripts in the top-level directory that should

doc/WEBSERVER.txt

@@ -16,9 +16,8 @@ Using Zope with an existing web server
   At this point you should perform any other steps you web server
   requires to install and configure a CGI script.
 
-  Note: For more information on PCGI check out Jeff Bauer's PCGI pages:
- 
-  http://starship.skyport.net/crew/jbauer/persistcgi/
+  Note: For more information on PCGI check out Jeff Bauer's "PCGI pages", 
+  http://starship.skyport.net/crew/jbauer/persistcgi/.
 
   When your Zope.cgi file is correctly configured as a CGI script with
   your web server, you are ready to access Zope through the web. You should
@@ -31,7 +30,28 @@ Using Zope with an existing web server
   You should be prompted to enter a username and password. Enter the Zope
   "super manager" name and password.
 
-Zope authentication with existing web servers.
+  Two ways to support PCGI
+
+    There are two ways to handle PCGI requests with Zope.
+
+    Using PCGI Publisher
+
+      By default, accessing Zope.cgi from your web server will
+      automatically cause a Python script, pcgi_publisher, to run.
+      This is a single-threaded application that serves PCGI requests
+      one at a time.  The script will run as whatever user (and with
+      whatever group) your web server uses to run CGI requests.
+
+    Using ZServer
+
+      The Zope 2 start script, z2.py will run ZServer and serve PCGI
+      requests by default.  ZServer is a multi-threaded server that
+      can simultaneously support multiple protocols, including PCGI,
+      HTTP, and FTP.  If Zope is started by root (on Unix) with z2.py,
+      then the Server will run as nobody, otherwise it will run as
+      whatever user ran z2.py.
+
+  Zope authentication with existing web servers.
 
     Zope normally performs both authentication and authorization of users.
     Some web servers don't pass authentication information to CGI scripts.
@@ -119,7 +139,7 @@ Zope authentication with existing web servers.
 	  the pre-defined acl_users in the top folder or add a User Folder
 	  object to a subfolder.
   
-Specific web servers
+  Specific web servers
   
     Apache