Fixed #3147 -- documented how to use .pth files for easy switching between

different versions of the code. Thanks to Waylan Limberg for the patch.


git-svn-id: http://code.djangoproject.com/svn/django/trunk@4479 bcc190cf-cafb-0310-a4f2-bffc1f526a37
This commit is contained in:
Malcolm Tredinnick 2007-02-10 08:55:18 +00:00
parent 937f3190ba
commit d8deb0c61c
2 changed files with 26 additions and 0 deletions

View File

@ -114,6 +114,7 @@ answer newbie questions, and generally made Django that much better:
Jeong-Min Lee <falsetru@gmail.com> Jeong-Min Lee <falsetru@gmail.com>
Christopher Lenz <http://www.cmlenz.net/> Christopher Lenz <http://www.cmlenz.net/>
lerouxb@gmail.com lerouxb@gmail.com
Waylan Limberg <waylan@gmail.com>
limodou limodou
mattmcc mattmcc
Martin Maney <http://www.chipy.org/Martin_Maney> Martin Maney <http://www.chipy.org/Martin_Maney>

View File

@ -484,6 +484,29 @@ Alternatively, you can use a symlink called ``django`` that points to the
location of the branch's ``django`` package. If you want to switch back, just location of the branch's ``django`` package. If you want to switch back, just
change the symlink to point to the old code. change the symlink to point to the old code.
A third option is to use a `path file`_ (``<something>.pth``) which should
work on all systems (including MS Windows, which doesn't have symlinks
available). First, make sure there are no files, directories or symlinks named
``django`` in your ``site-packages`` directory. Then create a text file named
``django.pth`` and save it to your ``site-packages`` directory. That file
should contain a path to your copy of Django on a single line and optional
comments. Here is an example that points to multiple branches. Just uncomment
the line for the branch you want to use ('Trunk' in this example) and make
sure all other lines are commented::
# Trunk is a svn checkout of:
# http://code.djangoproject.com/svn/django/trunk/
#
/path/to/trunk
# <branch> is a svn checkout of:
# http://code.djangoproject.com/svn/django/branches/<branch>/
#
#/path/to/<branch>
# On windows a path may look like this:
# C:/path/to/<branch>
If you're using Django 0.95 or earlier and installed it using If you're using Django 0.95 or earlier and installed it using
``python setup.py install``, you'll have a directory called something like ``python setup.py install``, you'll have a directory called something like
``Django-0.95-py2.4.egg`` instead of ``django``. In this case, edit the file ``Django-0.95-py2.4.egg`` instead of ``django``. In this case, edit the file
@ -491,6 +514,8 @@ If you're using Django 0.95 or earlier and installed it using
file. Then copy the branch's version of the ``django`` directory into file. Then copy the branch's version of the ``django`` directory into
``site-packages``. ``site-packages``.
.. _path file: http://docs.python.org/lib/module-site.html
Official releases Official releases
================= =================