summaryrefslogtreecommitdiff
path: root/docs/ref/databases.txt
diff options
context:
space:
mode:
authorTim Graham <timograham@gmail.com>2015-02-16 14:28:41 -0500
committerTim Graham <timograham@gmail.com>2015-02-16 14:29:34 -0500
commite38499123278b75f9cfd0348a5d125336dab3fa5 (patch)
treee6b0c3ec1524c15d423eb79f5c753fc072a421d2 /docs/ref/databases.txt
parenta970c277305d7cfa17b290667ce2a145abf96711 (diff)
[1.7.x] Removed a note about old versions of MySQLdb.
Backport of f3bc7c5447a1e4bfa428a7ff32ea3336850c5c2d from master
Diffstat (limited to 'docs/ref/databases.txt')
-rw-r--r--docs/ref/databases.txt24
1 files changed, 8 insertions, 16 deletions
diff --git a/docs/ref/databases.txt b/docs/ref/databases.txt
index 24e593569e..ddf9a26052 100644
--- a/docs/ref/databases.txt
+++ b/docs/ref/databases.txt
@@ -279,26 +279,18 @@ MySQLdb
Django requires MySQLdb version 1.2.1p2 or later.
-.. note::
- If you see ``ImportError: cannot import name ImmutableSet`` when trying to
- use Django, your MySQLdb installation may contain an outdated ``sets.py``
- file that conflicts with the built-in module of the same name from Python
- 2.4 and later. To fix this, verify that you have installed MySQLdb version
- 1.2.1p2 or newer, then delete the ``sets.py`` file in the MySQLdb
- directory that was left by an earlier version.
+At the time of writing, the latest release of MySQLdb (1.2.5) doesn't support
+Python 3. In order to use MySQLdb under Python 3, you'll have to install
+``mysqlclient`` instead.
.. note::
There are known issues with the way MySQLdb converts date strings into
- datetime objects. Specifically, date strings with value 0000-00-00 are
- valid for MySQL but will be converted into None by MySQLdb.
-
- This means you should be careful while using loaddata/dumpdata with rows
- that may have 0000-00-00 values, as they will be converted to None.
+ datetime objects. Specifically, date strings with value ``0000-00-00`` are
+ valid for MySQL but will be converted into ``None`` by MySQLdb.
-.. note::
- At the time of writing, the latest release of MySQLdb (1.2.4) doesn't
- support Python 3. In order to use MySQLdb under Python 3, you'll have to
- install ``mysqlclient``.
+ This means you should be careful while using :djadmin:`loaddata` and
+ :djadmin:`dumpdata` with rows that may have ``0000-00-00`` values, as they
+ will be converted to ``None``.
mysqlclient
~~~~~~~~~~~