Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Browse files

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

…tween

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
  • Loading branch information...
commit d8deb0c61cdcd99ed2cede8d65d4fd30458f4dbc 1 parent 937f319
@malcolmt malcolmt authored
Showing with 26 additions and 0 deletions.
  1. +1 −0  AUTHORS
  2. +25 −0 docs/contributing.txt
View
1  AUTHORS
@@ -114,6 +114,7 @@ answer newbie questions, and generally made Django that much better:
Jeong-Min Lee <falsetru@gmail.com>
Christopher Lenz <http://www.cmlenz.net/>
lerouxb@gmail.com
+ Waylan Limberg <waylan@gmail.com>
limodou
mattmcc
Martin Maney <http://www.chipy.org/Martin_Maney>
View
25 docs/contributing.txt
@@ -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
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
``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
@@ -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
``site-packages``.
+.. _path file: http://docs.python.org/lib/module-site.html
+
Official releases
=================
Please sign in to comment.
Something went wrong with that request. Please try again.