From 1caa6c77509c1453fb36dfa498b94358015d6b66 Mon Sep 17 00:00:00 2001 From: "Tim D. Smith" Date: Thu, 22 Sep 2016 12:39:35 -0700 Subject: [PATCH 1/4] CLT are not needed if full Xcode is installed --- docs/starting/install/osx.rst | 4 ---- 1 file changed, 4 deletions(-) diff --git a/docs/starting/install/osx.rst b/docs/starting/install/osx.rst index 4222485..b6eb135 100644 --- a/docs/starting/install/osx.rst +++ b/docs/starting/install/osx.rst @@ -32,10 +32,6 @@ package. 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. - 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. `Homebrew `_ fills this void. From 359e4b9e3d066d3f3f9c10dbad2af5bf4e78220a Mon Sep 17 00:00:00 2001 From: "Tim D. Smith" Date: Thu, 22 Sep 2016 12:40:43 -0700 Subject: [PATCH 2/4] Don't specifically need gcc --- docs/starting/install/osx.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/starting/install/osx.rst b/docs/starting/install/osx.rst index b6eb135..3d14254 100644 --- a/docs/starting/install/osx.rst +++ b/docs/starting/install/osx.rst @@ -21,10 +21,10 @@ 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 `_, the smaller -`Command Line Tools `_ (must have an -Apple account) or the even smaller `OSX-GCC-Installer `_ +Before installing Python, you'll need to install a C compiler. A compiler can be +obtained by downloading `Xcode `_, the +smaller `Command Line Tools `_ (must +have an Apple account) or the even smaller `OSX-GCC-Installer `_ package. .. note:: From 1d516898b3f6872b8cda1b823797781f64cfb87d Mon Sep 17 00:00:00 2001 From: "Tim D. Smith" Date: Thu, 22 Sep 2016 12:45:16 -0700 Subject: [PATCH 3/4] Update guidance on C toolchains --- docs/starting/install/osx.rst | 16 +++++++++------- 1 file changed, 9 insertions(+), 7 deletions(-) diff --git a/docs/starting/install/osx.rst b/docs/starting/install/osx.rst index 3d14254..e8aa1df 100644 --- a/docs/starting/install/osx.rst +++ b/docs/starting/install/osx.rst @@ -21,16 +21,18 @@ Doing it Right Let's install a real version of Python. -Before installing Python, you'll need to install a C compiler. A compiler can be -obtained by downloading `Xcode `_, the -smaller `Command Line Tools `_ (must -have an Apple account) or the even smaller `OSX-GCC-Installer `_ +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 `_ from the Mac App Store, or the +minimal but unofficial +`OSX-GCC-Installer `_ 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. + 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. From 2423a9da64181d8a55be72fc269e7f6ac3d011f1 Mon Sep 17 00:00:00 2001 From: "Tim D. Smith" Date: Thu, 22 Sep 2016 12:45:24 -0700 Subject: [PATCH 4/4] Offer guidance on Python 3 --- docs/starting/install/osx.rst | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/starting/install/osx.rst b/docs/starting/install/osx.rst index e8aa1df..5c73d69 100644 --- a/docs/starting/install/osx.rst +++ b/docs/starting/install/osx.rst @@ -61,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.