Skip to content

Update OS X install guidance #749

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
kennethreitz merged 4 commits into from
Oct 31, 2016
Merged

Update OS X install guidance #749

Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
1caa6c7
CLT are not needed if full Xcode is installed
tdsmith Sep 22, 2016
359e4b9
Don't specifically need gcc
tdsmith Sep 22, 2016
1d51689
Update guidance on C toolchains
tdsmith Sep 22, 2016
2423a9d
Offer guidance on Python 3
tdsmith Sep 22, 2016
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 15 additions & 11 deletions docs/starting/install/osx.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -21,20 +21,18 @@ Doing it Right

Let's install a real version of Python.

Before installing Python, you'll need to install GCC. GCC can be obtained
by downloading `Xcode <http://developer.apple.com/xcode/>`_, the smaller
`Command Line Tools <https://developer.apple.com/downloads/>`_ (must have an
Apple account) or the even smaller `OSX-GCC-Installer <https://github.com/kennethreitz/osx-gcc-installer#readme>`_
Before installing Python, you'll need to install a C compiler. The fastest way
is to install the Xcode Command Line Tools by running
``xcode-select --install``. You can also download the full version of
`Xcode <http://developer.apple.com/xcode/>`_ from the Mac App Store, or the
minimal but unofficial
`OSX-GCC-Installer <https://github.com/kennethreitz/osx-gcc-installer#readme>`_
package.

.. note::
If you already have Xcode installed, do not install OSX-GCC-Installer.
In combination, the software can cause issues that are difficult to
diagnose.

.. note::
If you perform a fresh install of Xcode, you will also need to add the
commandline tools by running ``xcode-select --install`` on the terminal.
If you already have Xcode installed or plan to use Homebrew, do not install
OSX-GCC-Installer. In combination, the software can cause issues that are
difficult to diagnose.

While OS X comes with a large number of UNIX utilities, those familiar with
Linux systems will notice one key component missing: a decent package manager.
Expand Down Expand Up @@ -63,6 +61,12 @@ Now, we can install Python 2.7:

$ brew install python

or Python 3:

.. code-block:: console

$ brew install python3

This will take a minute or two.


Expand Down