django/django — pull request #136 by carljm (2012-04-13 18:12:12+00:00)
Title: Ticket 18115: setup.py warning on overlaid install, and doc fixes

This patch takes the following actions to address the problem in https://code.djangoproject.com/ticket/18115:

1. Modifies Django's `setup.py` to issue a loud and descriptive warning anytime it installs over top of an existing installation that has not been removed. This doesn't cause any functional change in setup.py, just additional stderr output in some cases.

2. Makes the following changes to the installation instructions:

a. Rework the "remove old Django versions" section to avoid users doing unnecessary work, and make the finding of an existing Django more reliable (just import django and find its path, rather than trying to find site-packages).

b. Add a warning in the section that documents how to install using `python setup.py install` that it's particularly important in this case to remove any existing Django first.

c. Add the option of `pip install -e` for using the Django development version, which is far easier than setting up the paths manually. Relegated the lengthy manual-path-setup instructions to their own section at the bottom.