Carl Meyer avatar Carl Meyer committed 332bf62

doc updates; consolidate easy_install comparison, remove note about not working on Windows

Comments (0)

Files changed (1)

 * Simple to define fixed sets of requirements and reliably reproduce a
   set of packages.
 
+pip doesn't do everything that easy_install does. Specifically:
+
+* It cannot install from eggs.  It only installs from source.  (In the
+  future it would be good if it could install binaries from Windows ``.exe``
+  or ``.msi`` -- binary install on other platforms is not a priority.)
+
+* It doesn't understand Setuptools extras (like ``package[test]``).  This should
+  be added eventually.
+
+* It is incompatible with some packages that extensively customize distutils
+  or setuptools in their ``setup.py`` files.
+
 pip is complementary with `virtualenv
 <http://pypi.python.org/pypi/virtualenv>`__, and it is encouraged that you use
 virtualenv to isolate your installation.
 `virtualenv email group
 <http://groups.google.com/group/python-virtualenv?hl=en>`_.
 
-Differences From easy_install
------------------------------
-
-pip cannot install some packages.  Specifically:
-
-* It cannot install from eggs.  It only installs from source.  (In the future it would be good if it could install binaries from Windows ``.exe`` or ``.msi`` -- binary install on other platforms is not a priority.)
-
-* It doesn't understand Setuptools extras (like ``package[test]``).  This should
-  be added eventually.
-
-* It is incompatible with some packages that customize distutils or setuptools
-  in their ``setup.py`` files.
-
-* Maybe it doesn't work on Windows.  At least, the author doesn't test on
-  Windows often.
-
-* It also has some extra features.  Extra features the author thinks are great.
-
 Uninstall
 ---------
 
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.