Jannis Leidel committed d76c996

More doc changes

Comments (0)

Files changed (3)

 tools that MyApp doesn't strictly require.
 You can also include "editable" packages -- packages that are checked out from
-subversion (in the future other VCS will be supported).  These are just like
-using the ``-e`` option to pip.  They look like::
+Subversion, Git and Mercurial.  These are just like using the ``-e`` option
+to pip.  They look like::
     -e svn+http://myrepo/svn/MyApp#egg=MyApp
-You have to start the URL with ``svn+`` (eventually you'll be able to use
-``hg+`` etc), and you have to include ``#egg=Package`` so pip knows what
-to expect at that URL.  You can also include ``@rev`` in the URL, e.g., ``@275``
-to check out revision 275.
+You have to start the URL with ``svn+`` (or ``git+`` or ``hg+``), and you
+have to include ``#egg=Package`` so pip knows what to expect at that URL.
+You can also include ``@rev`` in the URL, e.g., ``@275`` to check out
+revision 275.
 Freezing Requirements
 News for pip
-svn trunk
+hg tip
 * Do not use ``sys.exit()`` from inside the code, instead use a
   return.  This will make it easier to invoke programmatically.
   Most importantly, anything that package requires will also be
   installed by pip.
+* Added support for editable packages created from Git and Mercurial
+  repositories and ability to freeze them.


 The requirements file format
-The requirements file is what poacheggs uses to install packages.
+The requirements file is what pip uses to install packages.
 This document describes that format.
 Each line of the requirements file indicates something to be
-tells poacheggs to install the 3.0 version of MyPackage.  
+tells pip to install the 3.0 version of MyPackage.  
 You can also install a package in an "editable" form.  This puts the
 source code into ``src/distname`` (making the name lower case) and
 install simply given the svn location, the project name is useful in
 other places.
-If you need to give poacheggs (and by association easy_install) hints
+If you need to give pip (and by association easy_install) hints
 about where to find a package, you can use the ``-f``
 (``--find-links``) option, like::
 Version Control
-Right now pip knows Subversion, Git and Mercurial.
+Right now pip knows Subversion, Git and Mercurial. Support for Bazaar is
+propably coming soon, too.
 You can also give specific revisions to an SVN URL, like::
-    -e svn+
+    -e svn+
 which will check out revision 2019.  ``@{20080101}`` would also check
 out the revision from 2008-01-01.  You can only check out specific
 revisions using ``-e svn+...``.
+Using Git and Mercurial is quite similar to that of Subversion -- just use the
+appropriate URL scheme. For a Git repository that is served with the Git
+protocoll you can use::
+    -e git://
+For a Git repository served over HTTP::
+    -e git+
+Passing branch names, a commit hash or a tag name is also possible:: 
+    -e git://
+    -e git://
+The same rules apply to Mercurial, use the ``hg+http`` URL scheme to get it
+over HTTP::
+    -e hg+
+You can also specify a revision number, a revision hash, a tag name or a local
+branch name to clone from::
+    -e hg+
+    -e hg+