Tweaked to reflect current state of install process.

README.txt

 ====
-ZODB 
+ZODB
 ====
 
 Introduction
@@ -13,7 +13,7 @@ follows:
 - Standard storages such as FileStorage
 - The persistent BTrees modules
 - ZEO, for scalability needs
-- documentation (needs more work)
+- documentation (needs a lot more work)
 
 Our primary development platforms are Linux, Mac OS X, and Windows
 XP.  The test suite should pass without error on all of these
@@ -24,7 +24,6 @@ you pass --all as an argument to test.py.
 Compatibility
 =============
 
-
 ZODB 3.9 requires Python 2.4.2 or later.
 
 ZODB ZEO clients from ZODB 3.2 on can talk to ZODB 3.9 servers.  ZODB
@@ -33,15 +32,13 @@ ZEO Clients can talk to ZODB 3.8 and 3.9 ZEO servers.
 Prerequisites
 =============
 
-You must have Python installed.  If you've installed Python from RPM,
-be sure that you've installed the development RPMs too, since ZODB
-builds Python extensions.  If you have the source release of ZODB,
-you will need a C compiler.
+You must have Python installed. If you're using a system Python
+install, make sure development support is installed too.
 
 You also need the transaction, zc.lockfile, ZConfig, zdaemon,
 zope.event, zope.interface, zope.proxy and zope.testing packages.  If
-you are using easy_install or zc.buildout to install ZODB, then these
-will be installed for you automatically.
+you don't have them and you can connect to the Python Package Index,
+then these will be installed for you if you don't have them.
 
 Installation
 ============
@@ -55,28 +52,23 @@ To install by hand, first install the dependencies, ZConfig, zdaemon,
 zope.interface, zope.proxy and zope.testing.  These can be found
 in the `Python Package Index <http://www.python.org/pypi>`_.
 
-To build it, run the setup script::
-
-    % python setup.py build
-
-The 64-bit support for the BTrees package may be enabled by using this
-build command instead::
+To run the tests, use the test setup command::
 
-    % python setup.py build_ext -DZODB_64BIT_INTS build
+  python setup.py test
 
-To test the build, run the test script::
+It will download dependencies if needed.  If this happens, ou may get
+an import error when the test command gets to looking for tests.  Try
+running the test command a second time and you should see the tests
+run.
 
-    % python test.py
+::
 
-For more verbose test output, append one or two '-v' arguments to this
-command.
+  python setup.py test
 
-If all the tests succeeded, you can install ZODB using the setup
-script::
+To install, use the install command::
 
-    % python setup.py install
+  python setup.py install
 
-This should now make all of ZODB accessible to your Python programs.
 
 Testing for Developers
 ======================