[Zodb-checkins] CVS: ZODB3 - README.txt:1.19.6.2

[Jeremy Hylton]

Update of /cvs-repository/ZODB3
In directory cvs.zope.org:/tmp/cvs-serv2880

Modified Files:
      Tag: Zope-2_7-branch
	README.txt 
Log Message:
Rearrange the introductory paragraphs.
Move parts to new Compatibility and License subheadings.
Fix licensing description for Andrew's guide.
Update number of tests run.
Add discussion of Zope compatibility.



=== ZODB3/README.txt 1.19.6.1 => 1.19.6.2 ===
--- ZODB3/README.txt:1.19.6.1	Tue Sep 23 16:45:28 2003
+++ ZODB3/README.txt	Tue Sep 30 15:36:01 2003
@@ -1,11 +1,5 @@
-ZODB3 3.2b3
-===========
-
-Please see the LICENSE.txt file for terms and conditions.
-
-Andrew Kuchling's ZODB/ZEO Programming Guide is provided verbatim
-under the terms of the GNU Free Documentation License.
-
+ZODB3 3.2 release candidate 1
+=============================
 
 Introduction
 ------------
@@ -16,16 +10,6 @@
 from the same source repository.  They have been packaged for use in
 non-Zope stand-alone Python applications.
 
-ZODB3 is known to work with Python 2.1.3, 2.2, and Python 2.3.  For
-best results, we recommend using Python 2.1.3 or Python 2.2.3.  Note
-that 2.2.1 does not work.
-
-Our primary development platforms are Linux and Windows 2000.  The
-test suite should pass without error on all of these platforms,
-although it can take a long time on Windows -- longer if you use
-ZoneAlarm.  (Many particularly slow tests are skipped unless you pass
---all as an argument to test.py.)
-
 The components you get with the ZODB3 release are as follows:
 
 - Core ZODB, including the persistence machinery
@@ -37,6 +21,33 @@
 - ZConfig -- a Zope configuration language
 - documentation
 
+Our primary development platforms are Linux and Windows 2000.  The
+test suite should pass without error on all of these platforms,
+although it can take a long time on Windows -- longer if you use
+ZoneAlarm.  Many particularly slow tests are skipped unless you pass
+--all as an argument to test.py.
+
+Compatibility
+-------------
+
+ZODB3 is known to work with Python 2.1.3, 2.2, and Python 2.3.  For
+best results, we recommend using Python 2.3.2, Python 2.2.3, or Python
+2.1.3.  Note that 2.2.1 does not work.
+
+This version of ZODB can be used with Zope, but you must replace the
+version of ZODB that comes packaged with Zope.  It should be possible,
+for example, to install this code into a Zope 2.6 software home and
+run with Python 2.2.  
+
+The Zope 2.7 release should be compatible with this version of ZODB.
+Note that Zope 2.7 will include ZEO, so this package should only be
+needed to run a ZEO server.
+
+The ZEO server in ZODB 3.2 is partially compatible with ZODB 3.1.  A
+new client can talk to an old server, but a new server can not talk to
+an old client.  If you want to upgrade without shutting down all
+components, you should upgrade all of the clients first.  Once all the
+clients are running the new software, you can safely upgrade the server.
 
 Prerequisites
 -------------
@@ -101,7 +112,7 @@
 number of tests can vary depending on platform and available
 third-party libraries.::
 
-    Ran 1025 tests in 141.977s
+    Ran 1182 tests in 241.269s
 
     OK
 
@@ -111,7 +122,7 @@
 time to run.  To run all the available tests use the ``--all`` option.
 Running all the tests takes much longer.::
 
-    Ran 1515 tests in 1123.557s
+    Ran 1561 tests in 1461.557s
 
     OK
 
@@ -151,6 +162,17 @@
 settled on the 3.1 version number so that we don't create the
 impression that this version of ZODB is the same as the one Jim
 described as ZODB 3 in 2000.
+
+License
+-------
+
+ZODB is distributed under the Zope Public License, an OSI-approved
+open source license.  Please see the LICENSE.txt file for terms and
+conditions.
+
+The ZODB/ZEO Programming Guide included in the documentation is a
+modified version of Andrew Kuchling's original guide, provided under
+the terms of the GNU Free Documentation License.
 
 
 More information