Skip to content

Commit

Permalink
DOC: extend instructions for Python.org Python
Browse files Browse the repository at this point in the history
Also - point to 'getting help' section in troubleshooting.
  • Loading branch information
matthew-brett committed Aug 7, 2014
1 parent 0769c6a commit 19bc8e5
Showing 1 changed file with 43 additions and 3 deletions.
46 changes: 43 additions & 3 deletions doc/faq/installing_faq.rst
Original file line number Diff line number Diff line change
Expand Up @@ -223,10 +223,42 @@ binaries in the form of wheels.
Python.org Python
^^^^^^^^^^^^^^^^^

* Install pip following instructions here: http://pip.readthedocs.org
First check that you do in fact have the Python.org python set to be the
default Python binary. From Terminal, do::

python -c 'import sys; print(sys.prefix)'

or::

python3 -c 'import sys; print(sys.prefix)'

Use ``python`` or ``python3`` depending whether you installed Python 2.7 or a
Python 3 release. You should see something like::

/Library/Frameworks/Python.framework/Versions/2.7

where "2.7" is your installed Python version. If you see something like
``/usr/bin/python`` instead, first try restarting Terminal.app;, if that
doesn't work then try reinstalling Python.org Python. If the check still
fails, we would like to hear about it. Please have a look at
:ref:`reporting-problems`.

Install pip following the `standard pip install instructions
<http://pip.readthedocs.org/en/latest/installing.html>`_. For the impatient,
in Terminal::

curl -O https://bootstrap.pypa.io/get-pip.py

Then::

python get-pip.py

or::

python3 get-pip.py

Install matplotlib and all its dependencies with::

pip install matplotlib

Macports
Expand Down Expand Up @@ -262,6 +294,14 @@ the IPython notebook option, like this:
* Homebrew ``pip2 install ipython[notebook]`` or ``pip3 install
ipython[notebook]``

In case of emergency...
^^^^^^^^^^^^^^^^^^^^^^^

If you get errors with pip trying to run a compiler like ``gcc`` or ``clang``,
first check :ref:`reporting-problems`, then you may need to `install xcode
<https://guide.macports.org/chunked/installing.html#installing.xcode>`_ and
try again.

Installing via OSX mpkg installer package
-----------------------------------------

Expand Down Expand Up @@ -339,8 +379,8 @@ restarting Terminal.app before running the check again. If that doesn't fix
the problem, depending on which Python you wanted to use, consider
reinstalling Python.org Python, or check your homebrew or macports setup.
Remember that the disk image installer only works for Python.org Python, and
will not get picked up by other Pythons. If all these fail, please contact
the mailing list.
will not get picked up by other Pythons. If all these fail, please let us
know: see :ref:`reporting-problems`.

Windows Notes
=============
Expand Down

0 comments on commit 19bc8e5

Please sign in to comment.