diff options
| author | Tim Graham <timograham@gmail.com> | 2015-10-21 14:59:03 -0400 |
|---|---|---|
| committer | Tim Graham <timograham@gmail.com> | 2015-10-22 10:09:04 -0400 |
| commit | 02f3084f4ee1ec4319439b99bd4cde9e27201778 (patch) | |
| tree | 62cf88fe89d72b7515f35c9e1cb6e1755cd20459 | |
| parent | 3d192b66a9b277dacf2f022209e5596c57a5ffa3 (diff) | |
[1.9.x] Fixed #25584 -- Documented a pip error when installing Django 1.9.
Backport of ee66d8dd7df8326c453fd04c2bdeb5225df934be from master
| -rw-r--r-- | docs/releases/1.9.txt | 23 | ||||
| -rw-r--r-- | docs/topics/install.txt | 3 |
2 files changed, 25 insertions, 1 deletions
diff --git a/docs/releases/1.9.txt b/docs/releases/1.9.txt index 1f8a127c4f..37ed66d7f0 100644 --- a/docs/releases/1.9.txt +++ b/docs/releases/1.9.txt @@ -1009,6 +1009,29 @@ a Django application with this structure:: jquery.js jquery.min.js +.. _syntax-error-old-pip-django-19: + +``SyntaxError`` when installing Django with pip ≤ 1.5.6 +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +When installing Django 1.9+ with pip ≤ 1.5.6, you'll see:: + + Compiling django/conf/app_template/apps.py ... + File "django/conf/app_template/apps.py", line 4 + class {{ camel_case_app_name }}Config(AppConfig): + ^ + SyntaxError: invalid syntax + + Compiling django/conf/app_template/models.py ... + File "django/conf/app_template/models.py", line 1 + {{ unicode_literals }}from django.db import models + ^ + SyntaxError: invalid syntax + +It's safe to ignore these errors (Django will still install just fine), and you +can avoid them by upgrading pip to a more recent version using +``pip install -U pip``. + Miscellaneous ~~~~~~~~~~~~~ diff --git a/docs/topics/install.txt b/docs/topics/install.txt index 2c4a422689..d560317808 100644 --- a/docs/topics/install.txt +++ b/docs/topics/install.txt @@ -165,7 +165,8 @@ This is the recommended way to install Django. 1. Install pip_. The easiest is to use the `standalone pip installer`_. If your distribution already has ``pip`` installed, you might need to update it if it's outdated. (If it's outdated, you'll know because installation won't - work.) + work. You might see some :ref:`harmless SyntaxErrors + <syntax-error-old-pip-django-19>` also.) 2. Take a look at virtualenv_ and virtualenvwrapper_. These tools provide isolated Python environments, which are more practical than installing |