From 0c97ce5a31f8110910232a68997ee33b5bf92924 Mon Sep 17 00:00:00 2001 From: Kenneth Reitz Date: Thu, 13 Apr 2017 10:43:58 -0400 Subject: [PATCH] update python 2 guides --- docs/starting/install/linux.rst | 20 ++++++++++---------- docs/starting/install/osx.rst | 4 ++-- docs/starting/install/win.rst | 18 ++++++++++-------- 3 files changed, 22 insertions(+), 20 deletions(-) diff --git a/docs/starting/install/linux.rst b/docs/starting/install/linux.rst index aa56ec0..c9b779b 100644 --- a/docs/starting/install/linux.rst +++ b/docs/starting/install/linux.rst @@ -1,9 +1,9 @@ .. _install-linux: -Installing Python on Linux -========================== +Installing Python 2 on Linux +============================ -The latest versions of CentOS, Fedora, Redhat Enterprise (RHEL) and Ubuntu +The latest versions of CentOS, Fedora, Redhat Enterprise (RHEL) and Ubuntu **come with Python 2.7 out of the box**. To see which version of Python you have installed, open a command prompt and run @@ -32,11 +32,11 @@ Setuptools & Pip The two most crucial third-party Python packages are `setuptools `_ and `pip `_. -Once installed, you can download, install and uninstall any compliant Python software -product with a single command. It also enables you to add this network installation +Once installed, you can download, install and uninstall any compliant Python software +product with a single command. It also enables you to add this network installation capability to your own Python software with very little work. -Python 2.7.9 and later (on the python2 series), and Python 3.4 and later include +Python 2.7.9 and later (on the python2 series), and Python 3.4 and later include pip by default. To see if pip is installed, open a command prompt and run @@ -50,15 +50,15 @@ To install pip, `follow the official pip installation guide ` docs. +To start using this and see more information: :ref:`Virtual Environments ` docs. You can also use :ref:`virtualenvwrapper ` to make it easier to manage your virtual environments. diff --git a/docs/starting/install/osx.rst b/docs/starting/install/osx.rst index 6312215..f0851d3 100644 --- a/docs/starting/install/osx.rst +++ b/docs/starting/install/osx.rst @@ -1,7 +1,7 @@ .. _install-osx: -Installing Python on Mac OS X -============================= +Installing Python 2 on Mac OS X +=============================== .. note:: Check out our :ref:`guide for installing Python 3 on OS X`. diff --git a/docs/starting/install/win.rst b/docs/starting/install/win.rst index 6496a3a..bbcae9c 100644 --- a/docs/starting/install/win.rst +++ b/docs/starting/install/win.rst @@ -1,10 +1,10 @@ .. _install-windows: -Installing Python on Windows -============================ +Installing Python 2 on Windows +============================== -First, download the `latest version `_ -of Python 2.7 from the official Website. If you want to be sure you are installing a fully +First, download the `latest version `_ +of Python 2.7 from the official website. If you want to be sure you are installing a fully up-to-date version, click the Downloads > Windows link from the home page of the `Python.org web site `_ . @@ -35,6 +35,8 @@ You can do this easily by running the following in ``powershell``: [Environment]::SetEnvironmentVariable("Path", "$env:Path;C:\Python27\;C:\Python27\Scripts\", "User") +This is also an option during the installation process. + The second (:file:`Scripts`) directory receives command files when certain packages are installed, so it is a very useful addition. You do not need to install or configure anything else to use Python. Having @@ -69,15 +71,15 @@ To install pip, run the Python script available here: Virtual Environments -------------------- -A Virtual Environment is a tool to keep the dependencies required by different projects -in separate places, by creating virtual Python environments for them. It solves the -"Project X depends on version 1.x but, Project Y needs 4.x" dilemma, and keeps +A Virtual Environment is a tool to keep the dependencies required by different projects +in separate places, by creating virtual Python environments for them. It solves the +"Project X depends on version 1.x but, Project Y needs 4.x" dilemma, and keeps your global site-packages directory clean and manageable. For example, you can work on a project which requires Django 1.10 while also maintaining a project which requires Django 1.8. -To start using this and see more information: :ref:`Virtual Environments ` docs. +To start using this and see more information: :ref:`Virtual Environments ` docs. --------------------------------