diff --git a/docs/installation.rst b/docs/installation.rst index 6d564ba..ae11c59 100644 --- a/docs/installation.rst +++ b/docs/installation.rst @@ -1,4 +1,4 @@ -Properly Installing Python +Properly Installing Python ========================== Mac OS X @@ -16,8 +16,8 @@ just import your application and start playing around. Package Manager --------------- -While Snow Leopard comes with a large number of UNIX utilities, those -familiar with Linux systems will notice one key component missing: a +While Snow Leopard comes with a large number of UNIX utilities, those +familiar with Linux systems will notice one key component missing: a package manager. Mxcl's *Homebrew* is the answer. To install Homebrew, simply run: :: @@ -25,37 +25,39 @@ To install Homebrew, simply run: :: $ ruby -e "$(curl -fsS http://gist.github.com/raw/323731/install_homebrew.rb)" -It's basic commands are **update**, **install**, and **remove**. +It's basic commands are **update**, **install**, and **remove**. .. man brew - -Python Interpreter ------------------- - And we can now install Python 2.7: :: $ brew install python --framework -The ``--framework`` option tells Homebrew to compile a Framework-style Python build, rather than a UNIX-style build. The outdated version of Python that Snow Leopard comes packaged with -is built as a Framework, so this helps avoid some future module installation -bugs. +The ``--framework`` option tells Homebrew to compile a Framework-style Python build, rather than a UNIX-style build. The outdated version of Python that Snow Leopard comes packaged with +is built as a Framework, so this helps avoid some future module installation +bugs. + +*Don't forget to update your environment PATH.* + + +Building From Source +-------------------- + -*Don't forget to update your environment PATH.* Distribute & Pip ---------------- -*Distribute* is a fantastic drop-in replacement for *easy_install* and -*setuptools*. It allows you to install and manage python packages from -pypi.python.org, amongst a few other sources. It also plays well with -*virtualenv* and user-enviornments. +*Distribute* is a fantastic drop-in replacement for *easy_install* and +*setuptools*. It allows you to install and manage python packages from +pypi.python.org, amongst a few other sources. It also plays well with +*virtualenv* and user-enviornments. -**easy_install** is considered by many to be a deprecated system, so we -will install it's replacement: **pip**. Pip allows for uninstallation +**easy_install** is considered by many to be a deprecated system, so we +will install it's replacement: **pip**. Pip allows for uninstallation of packages, and is actively maintained, unlike setuptool's easy_install. To install *pip* and Distribute's *easy_install*: @@ -63,7 +65,7 @@ To install *pip* and Distribute's *easy_install*: If you have homebrew: :: $ brew install pip - + ...And, if you're a masochist: :: $ curl -O http://python-distribute.org/distribute_setup.py @@ -92,7 +94,7 @@ Windows -Prerequisites: +Prerequisites: -------------- * Python2.7 (x86) from Python.org @@ -104,7 +106,7 @@ Step 1: Install Distribute & Pip **Distribute** is a fantastic drop-in replacement for **easy_install** and **setuptools**. It allows you to install and manage python packages from PyPi, amongst a few other sources. -To install it, run the python script available here: +To install it, run the python script available here: Make sure that ```C:\Python27\```, and ```C:\Python27\Scripts``` are in your PATH.