Merge pull request #181 from mattupstate/master

Add notes about easy_install and pip

rst/modules.rst

@@ -213,14 +213,14 @@ Example action from Ansible :doc:`playbooks`::
 
 
 
-.. _easyinstall:
+.. _easy_install:
 
 easy_install
 ````````````
 
 .. versionadded:: 0.7
 
-The easy_install module installs Python libraries.
+The easy_install module installs Python libraries. 
 
 +--------------------+----------+---------+----------------------------------------------------------------------------+
 | parameter          | required | default | comments                                                                   |
@@ -231,9 +231,16 @@ The easy_install module installs Python libraries.
 |                    |          |         | does not exist it is created automatically                                 |
 +--------------------+----------+---------+----------------------------------------------------------------------------+
 
+Please note that the easy_install command can only install Python libraries. 
+Thus this module is not able to remove libraries. It is generally recommended to 
+use the :ref:`pip` module which you can first install using easy_install. 
+
+Also note that `virtualenv <http://www.virtualenv.org/>`_ must be installed on 
+the remote host if the `virtualenv` parameter is specified.
+
 Example action from Ansible :doc:`playbooks`::
 
-    easy_install name=flask
+    easy_install name=pip
     easy_install name=flask==0.8
     easy_install name=flask virtualenv=/srv/webapps/my_app/venv
 
@@ -576,6 +583,9 @@ Manages Python library dependencies.
 | state              | no       | present | 'present', 'absent' or 'latest'                                            |
 +--------------------+----------+---------+----------------------------------------------------------------------------+
 
+Please note that `virtualenv <http://www.virtualenv.org/>`_ must be installed on
+the remote host if the `virtualenv` parameter is specified.
+
 Examples::
 
     pip name=flask