Ticket #15058: 15058.diff

docs/howto/deployment/modwsgi.txt

@@ -42 +42 @@
 
     os.environ['DJANGO_SETTINGS_MODULE'] = 'mysite.settings'
 
+    sys.path.append('/path/to')
+    sys.path.append('/path/to/mysite')
+
     import django.core.handlers.wsgi
     application = django.core.handlers.wsgi.WSGIHandler()
 
-If your project is not on your ``PYTHONPATH`` by default you can add::
+The first directory added to ``sys.path`` allows Python to import your
+application, starting with your settings modules. The second directory is
+necessary if you have left out the name of your project in your imports,
+which is recommended for pluggable apps.
 
-    path = '/path/to/mysite'
-    if path not in sys.path:
-        sys.path.append(path)
+If these directories are already on your ``PYTHONPATH`` by default, you can
+omit these lines.
 
-just below the ``import sys`` line to place your project on the path. Remember to
-replace 'mysite.settings' with your correct settings file, and '/path/to/mysite'
-with your own project's location.
+Remember to replace 'mysite.settings' with your correct settings file, and
+'/path/to/mysite' with your own project's location. The example above assumes
+that you have run 'django-admin.py startproject mysite' in '/path/to'.
 
 .. _serving-media-files: