Browse files

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


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

git-svn-id: bcc190cf-cafb-0310-a4f2-bffc1f526a37
  • Loading branch information...
1 parent 937f319 commit d8deb0c61cdcd99ed2cede8d65d4fd30458f4dbc @malcolmt malcolmt committed Feb 10, 2007
Showing with 26 additions and 0 deletions.
  1. +1 −0 AUTHORS
  2. +25 −0 docs/contributing.txt
@@ -114,6 +114,7 @@ answer newbie questions, and generally made Django that much better:
Jeong-Min Lee <>
Christopher Lenz <>
+ Waylan Limberg <>
Martin Maney <>
@@ -484,13 +484,38 @@ 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
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:
+ #
+ #
+ /path/to/trunk
+ # <branch> is a svn checkout of:
+ #<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
``python install``, you'll have a directory called something like
``Django-0.95-py2.4.egg`` instead of ``django``. In this case, edit the file
``setuptools.pth`` and remove the line that references the Django ``.egg``
file. Then copy the branch's version of the ``django`` directory into
+.. _path file:
Official releases

0 comments on commit d8deb0c

Please sign in to comment.