[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}