diff --git a/docs/quickstart.rst b/docs/quickstart.rst index 4e8844b..7682ced 100644 --- a/docs/quickstart.rst +++ b/docs/quickstart.rst @@ -1,3 +1,4 @@ + ================== Getting Tahoe-LAFS ================== @@ -9,33 +10,32 @@ decentralized, fault-tolerant storage system. `About Tahoe-LAFS How To Get Tahoe-LAFS ===================== -This procedure has been verified to work on Windows, Mac, OpenSolaris, -and too many flavors of Linux and of BSD to list. It's likely to work -on other platforms. +This procedure has been verified to work on Windows, Mac, OpenSolaris, and +too many flavors of Linux and of BSD to list. It's likely to work on other +platforms. In Case Of Trouble ------------------ -There are a few 3rd party libraries that Tahoe-LAFS depends on that -might not be easy to set up on your platform. If the following -instructions don't Just Work without any further effort on your part, -then please write to `the tahoe-dev mailing list -`_ where -friendly hackers will help you out. +There are a few 3rd party libraries that Tahoe-LAFS depends on that might not +be easy to set up on your platform. If the following instructions don't Just +Work without any further effort on your part, then please write to `the +tahoe-dev mailing list +`_ where friendly +hackers will help you out. Install Python -------------- -Check if you already have an adequate version of Python installed by -running ``python -V``. Python v2.4 (v2.4.4 or greater), Python v2.5, -Python v2.6, or Python v2.7 will work. Python v3 does not work. On -Windows, we recommend the use of Python v2.6 (native, not Cygwin). If -you don't have one of these versions of Python installed, then follow -the instructions on `the Python download page -`_ to download and -install Python v2.6. Make sure that the path to the installation -directory has no spaces in it (e.g. on Windows, do not install Python -in the "Program Files" directory). +Check if you already have an adequate version of Python installed by running +``python -V``. Python v2.4 (v2.4.4 or greater), Python v2.5, Python v2.6, or +Python v2.7 will work. Python v3 does not work. On Windows, we recommend the +use of native Python, not Cygwin. If you don't have one of these versions of +Python installed, then follow the instructions on `the Python download page +`_ to download and install +Python v2.7. Make sure that the path to the installation directory has no +spaces in it (e.g. on Windows, do not install Python in the "Program Files" +directory). Get Tahoe-LAFS -------------- @@ -49,38 +49,22 @@ Set Up Tahoe-LAFS Unpack the zip file and cd into the top-level directory. Run ``python setup.py build`` to generate the ``tahoe`` executable in a -subdirectory of the current directory named ``bin``. This will download -and build anything you need from various websites. +subdirectory of the current directory named ``bin``. This will download and +build anything you need from various websites. -On Windows, the ``build`` step might tell you to open a new Command -Prompt (or, on XP and earlier, to log out and back in again). This is -needed the first time you set up Tahoe-LAFS on a particular -installation of Windows. +On Windows, the ``build`` step might tell you to open a new Command Prompt +(or, on XP and earlier, to log out and back in again). This is needed the +first time you set up Tahoe-LAFS on a particular installation of Windows. -Optionally run ``python setup.py test`` to verify that it passes all of -its self-tests. +Optionally run ``python setup.py test`` to verify that it passes all of its +self-tests. -Run ``bin/tahoe --version`` (on Windows, ``bin\tahoe --version``) to -verify that the executable tool prints out the right version number. +Run ``bin/tahoe --version`` (on Windows, ``bin\tahoe --version``) to verify +that the executable tool prints out the right version number. Run Tahoe-LAFS -------------- Now you are ready to deploy a decentralized filesystem. The ``tahoe`` -executable in the ``bin`` directory can configure and launch your -Tahoe-LAFS nodes. See `running.rst `_ for instructions on -how to do that. - -Advanced Installation ---------------------- - -For optional features such as tighter integration with your operating -system's package manager, you can see the `AdvancedInstall -`_ wiki page. -The options on that page are not necessary to use Tahoe-LAFS and can be -complicated, so we do not recommend following that page unless you have -unusual requirements for advanced optional features. For most people, -you should first follow the instructions on this page, and if that -doesn't work then ask for help by writing to `the tahoe-dev mailing -list `_. - +executable in the ``bin`` directory can configure and launch your Tahoe-LAFS +nodes. See `running.rst `_ for instructions on how to do that.