From 5c688df8626ae0edd586fc23df95b7510fe48f89 Mon Sep 17 00:00:00 2001 From: ryneeverett Date: Wed, 3 Jun 2015 06:33:06 -0400 Subject: [PATCH] Clarify VCS installation behavior. Resolve #2837. --- docs/reference/pip_install.rst | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/docs/reference/pip_install.rst b/docs/reference/pip_install.rst index 437d616ee..2602a916d 100644 --- a/docs/reference/pip_install.rst +++ b/docs/reference/pip_install.rst @@ -260,7 +260,10 @@ the :ref:`--editable ` option) or not. for global installs. The :ref:`--src ` option can be used to modify this location. * For non-editable installs, the project is built locally in a temp dir and then - installed normally. + installed normally. Note that if a satisfactory version of the package is + already installed, the VCS source will not overwrite it without an `--upgrade` + flag. VCS requirements pin the package version (specified in the `setup.py` + file) of the target commit, not necessarily the commit itself. The "project name" component of the url suffix "egg=-" is used by pip in its dependency logic to identify the project prior