Modify setuptools and pip docs for OSX

[mandarg]

Clarify a little more what setuptools allows you to do, what pip is, and what advantages it has over easy_install provided by Setuptools.

This makes the docs sound somewhat opinionated, but simplifies things a little for new users. If we mention Setuptools, easy_install should be mentioned at least; and then some information towards why a lot of people will say "just use pip!".

Let me know if some wording should be changed, or if you think the documentation as existing is better.

[sigmavirus24]

I'm fairly certain (although it's been a while and I could be wrong) that easy_install is present regardless of setuptools and is in fact provided by distutils. Assuming that's correct, then there's no need to mention it because we're mentioning setuptools. Further, I feel the documentation was better as it was written before with one caveat:

1. The last sentence of the first paragraph should be removed. It is out of place and not in any way supposed to be part of that paragraph.

[mandarg]

Setuptools' documentation says that they bundle easy_install (https://pythonhosted.org/setuptools/easy_install.html#using-easy-install). The distutils documentation does not include any description of installation using easy_install (https://docs.python.org/2/install/index.html#install-index).

Could you clarify whether this is correct? Perhaps I'm not seeing something correctly.

[kennethreitz]

I believe easy_install is only available via setuptools/distribute.

[mandarg]

@sigmavirus24 Does that clear up the inclusion of easy_install?

If you still think the documentation is better as-is, feel free to close the PR. Thanks! 🍰

[sigmavirus24]

Please remove "also" from this sentence and use two backticks (`) around pip, e.g.,

``pip``

[sigmavirus24]

@mandarg sorry for the confusion. There are just a couple of edits that I'd like you to make before I merge this. Thanks

[mandarg]

No problem, put in the changes you suggested :)

[sigmavirus24]

Looks good! I'll merge it in the morning

[sigmavirus24]

Thanks @mandarg! 🍰