[Zodb-checkins] CVS: ZODB3/Doc/guide - prog-zodb.tex:1.2.4.5

Jeremy Hylton jeremy@zope.com
Fri, 4 Oct 2002 15:08:07 -0400


Update of /cvs-repository/ZODB3/Doc/guide
In directory cvs.zope.org:/tmp/cvs-serv27572

Modified Files:
      Tag: ZODB3-3_1-branch
	prog-zodb.tex 
Log Message:
Chuck most of the old install/requirements stuff and refer to
README.txt.


=== ZODB3/Doc/guide/prog-zodb.tex 1.2.4.4 => 1.2.4.5 ===
--- ZODB3/Doc/guide/prog-zodb.tex:1.2.4.4	Fri Oct  4 14:44:27 2002
+++ ZODB3/Doc/guide/prog-zodb.tex	Fri Oct  4 15:08:07 2002
@@ -23,59 +23,21 @@
 
 \subsubsection{Requirements}
 
-You'll need Python, of course; version 1.5.2 works with some fixes,
-and it also works with Python 2.0, which is what I primarily use.
-
-The code is packaged using Distutils, the new distribution tools for
-Python introduced in Python 2.0.  If you're using 1.5.2, first you'll
-have to get the latest Distutils release from the Distutils SIG page
-at \url{http://www.python.org/sigs/distutils-sig/download.html} and
-install it.  This is simply a matter of untarring or unzipping the
+You will need Python 2.1 or higher.  The code is packaged using
+Distutils.  So it is simply a matter of untarring or unzipping the
 release package, and then running \code{python setup.py install}.
 
-If you're using 1.5.2 and have installed previous versions of the
-Distutils, be sure to get the very latest version, since developing
-the ZODB distribution turned up some bugs along the way.  If you
-encounter problems compiling \file{ZODB/TimeStamp.c} or your compiler reports
-an error like ``Can't create build/temp.linux2/ExtensionClass.o: No
-such file or directory'', you need an updated version.  Old versions of
-Distutils have two bugs which affect the setup scripts.  First, for a
-long time the \code{define_macros} keyword in setup.py files didn't work due
-to a Distutils bug, so I hacked TimeStamp.c in earlier releases.  The
-Distutils have since been fixed, and the hack became unnecessary, so I
-removed it.  Second, the code that creates directories tries to be
-smart and caches them to save time by not trying to create a directory
-twice, but this code was broken in old versions.
-
 You'll need a C compiler to build the packages, because there are
 various C extension modules.  At the moment no one is making Windows
-binaries available, so you'll need a Windows development environment to use the 
+binaries available, so you'll need a Windows development environment
+to build ZODB.
 
 \subsubsection{Installing the Packages}
 
 Download the ZODB tarball containing all the packages for both ZODB
-and ZEO from \url{http://www.amk.ca/files/zodb/}.
-
-To build the packages, you must go into the individual directories and
-build and install them one by one.  They should be built and installed
-in this order:
- 
-\begin{enumerate}
-  \item \code{zodb-basic}
-  \item ExtensionClass
-  \item ZODB
-  \item \code{BTrees}
-  \item ZEO
-\end{enumerate}
-
-In particular, you must install ExtensionClass before building the
-ZODB package; otherwise, the compilation in the ZODB package will die
-complaining that it can't find ExtensionClass.h.  You can manually
-hack the \#include path to make it work without installing
-ExtensionClass first, but that's a bit hackish.
-
-If you encounter any problems, please let me know at
-\email{akuchlin@mems-exchange.org}.
+and ZEO from \url{http://www.zope.org/Products/StandaloneZODB}.  See
+the \file{README.txt} file in the top level of the release directory
+for details on building, testing, and installing.
 
 \subsection{How ZODB Works}