From 1455e41ed8758c14a79e1a3a70d96b85b0573542 Mon Sep 17 00:00:00 2001
From: Jannis Leidel <jannis@leidel.info>
Date: Tue, 23 Jul 2013 22:41:01 +0200
Subject: [PATCH] More doc updates.

---
 docs/index.rst | 25 ++++++++++++++-----------
 docs/news.rst  |  2 ++
 2 files changed, 16 insertions(+), 11 deletions(-)

diff --git a/docs/index.rst b/docs/index.rst
index a5c5fa282..0cd51e23f 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -6,7 +6,7 @@ virtualenv
 `Issues <https://github.com/pypa/virtualenv/issues>`_ `|`
 `Github <https://github.com/pypa/virtualenv>`_ `|`
 `PyPI <https://pypi.python.org/pypi/virtualenv/>`_ `|`
-irc:#pip
+IRC: #pip on Freenode
 
 .. comment: split here
 
@@ -42,20 +42,21 @@ Installation
 
 .. warning::
 
-    We advise installing virtualenv-1.9 or greater. Prior to version 1.9, the pip included in virtualenv did not
-    not download from PyPI over SSL.
+    We advise installing virtualenv-1.9 or greater. Prior to version 1.9, the
+    pip included in virtualenv did not not download from PyPI over SSL.
 
 .. warning::
 
-    When using pip to install virtualenv, we advise using pip-1.3 or greater. Prior to version 1.3, pip did not
-    not download from PyPI over SSL.
+    When using pip to install virtualenv, we advise using pip 1.3 or greater.
+    Prior to version 1.3, pip did not not download from PyPI over SSL.
 
 .. warning::
 
-    We advise against using easy_install to install virtualenv, because easy_install
-    does not download from PyPI over SSL.
+    We advise against using easy_install to install virtualenv when using
+    setuptools < 0.9.7, because easy_install didn't download from PyPI over SSL
+    and was broken in some subtle ways.
 
-To install globally with `pip` (if you have pip-1.3 or greater installed globally):
+To install globally with `pip` (if you have pip 1.3 or greater installed globally):
 
 ::
 
@@ -453,9 +454,11 @@ If you use this flag to create an environment, currently, the
 The ``--extra-search-dir`` option
 ---------------------------------
 
-.. note:: Currently, this feature only partially works for pip, and not at
-all for setuptools. For details, see
-`Issue #327 <https://github.com/pypa/virtualenv/issues/327>`_
+.. note::
+
+    Currently, this feature only partially works for pip, and not at
+    all for setuptools. For details,
+    see `Issue #327 <https://github.com/pypa/virtualenv/issues/327>`_
 
 This option allows you to provide your own versions of setuptools
 and/or pip on the filesystem, and tell virtualenv to use those distributions
diff --git a/docs/news.rst b/docs/news.rst
index 5823a9299..dc7e18447 100644
--- a/docs/news.rst
+++ b/docs/news.rst
@@ -44,6 +44,8 @@ Changes & News
 
 * Fixed issue with readline on Windows.
 
+.. _Distribute: https://pypi.python.org/pypi/distribute
+
 1.9.1 (2013-03-08)
 ~~~~~~~~~~~~~~~~~~