From: Zooko O'Whielacronx Date: Tue, 20 Nov 2007 20:39:22 +0000 (-0700) Subject: setup: README: warn against Python 2.4.1, recommend easy_install, link to easy_instal... X-Git-Url: https://git.rkrishnan.org/module-simplejson.decoder.html?a=commitdiff_plain;h=e8b4f025e2e7d058c412b8d9ee323bab636a961a;p=tahoe-lafs%2Ftahoe-lafs.git setup: README: warn against Python 2.4.1, recommend easy_install, link to easy_install download page, edit for clarity --- diff --git a/README b/README index e5602da3..3e9db8df 100644 --- a/README +++ b/README @@ -51,7 +51,8 @@ The Manual Dependencies: + GNU make (build tool) - + Python 2.4 or newer (tested against 2.4, and 2.5.1), including + + Python 2.4 or newer (tested against 2.4.4, and 2.5.1 -- note that 2.4.1 is + known not to work due to a bug in its base-32 encoder), including development headers i.e. "Python.h" (language) http://python.org/ @@ -116,20 +117,28 @@ http://allmydata.org/source/tahoe/ INSTALLING: There are four ways to do it: The easy_install Way, The Setuptools Way, The -Running-In-Place Way, and The Debian Way. Choose one: +Running-In-Place Way, and The Debian Way. Choose one. If you're not sure, +choose the easy_install way. The easy_install Way: - You don't need to download the source code first. + You don't need to download the source code first. You do need to have the + "easy_install" tool installed first: - Tahoe is registered with the Python Package Index (PyPI), so the - 'easy_install' tool can download and install it for you. Just type + http://peak.telecommunity.com/DevCenter/EasyInstall#installing-easy-install + + The 'easy_install' tool can download and install tahoe for you. Just type 'easy_install allmydata-tahoe' from any shell. That will download the most recent Tahoe source tarball, unpack it in a temporary directory, install it to the standard location, then download and install any easy_install-able dependencies that you need (setuptools, zfec, foolscap, simplejson, nevow, - and pycryptopp). (This will work only if you already have the dependencies - listed in the MANUAL DEPENDENCIES section, above.) + and pycryptopp). (This will work only if you have already installed the + dependencies listed in the MANUAL DEPENDENCIES section, above.) + + The end result will be that the Tahoe code is installed to the standard + location for libraries on your operating system (on unix, that is somewhere + inside /usr/lib/), and the "tahoe" executable will be installed to the + standard location for executables on operating system. The Setuptools Way: @@ -139,11 +148,18 @@ Running-In-Place Way, and The Debian Way. Choose one: to the standard location for your operating system (on unix, that is somewhere inside /usr/lib/). It will also acquire and install the easy_install-able dependencies (setuptools, zfec, foolscap, simplejson, - nevow, and pycryptopp) to the same place. + nevow, and pycryptopp) to the same place. (This will work only if you have + already installed the dependencies listed in the MANUAL DEPENDENCIES + section, above.) (To install it to a non-standard location, see http://allmydata.org/trac/tahoe/wiki/SetuptoolsAndGNUStow .) + The end result will be that the Tahoe code is installed to the standard + location for libraries on your operating system (on unix, that is somewhere + inside /usr/lib/), and the "tahoe" executable will be installed to the + standard location for executables on operating system. + The Running-In-Place Way: You can use Tahoe without installing it. The steps are these: