Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Browse files

Fixed #10377: Added clearer warning to database notes for cx_Oracle 5.0.

git-svn-id: http://code.djangoproject.com/svn/django/trunk@9922 bcc190cf-cafb-0310-a4f2-bffc1f526a37
  • Loading branch information...
commit 5fcd75ce141b43059c722ff1f92e671d9e1a1997 1 parent db2a95f
James Bennett ubernostrum authored
Showing with 13 additions and 7 deletions.
  1. +9 −4 docs/ref/databases.txt
  2. +4 −3 docs/topics/install.txt
13 docs/ref/databases.txt
View
@@ -366,10 +366,15 @@ version of SQLite.
Oracle notes
============
-Django supports `Oracle Database Server`_ versions 9i and higher. Oracle
-version 10g or later is required to use Django's ``regex`` and ``iregex`` query
-operators. You will also need a 4.X release of the `cx_Oracle`_ driver,
-version 4.3.1 or newer.
+Django supports `Oracle Database Server`_ versions 9i and
+higher. Oracle version 10g or later is required to use Django's
+``regex`` and ``iregex`` query operators. You will also need at least
+version 4.3.1 of the `cx_Oracle`_ Python driver.
+
+Note that due to a Unicode-corruption bug in ``cx_Oracle`` 5.0, that
+version of the driver should **not** be used with Django;
+``cx_Oracle`` 5.0.1 resolved this issue, so if you'd like to use a
+more recent ``cx_Oracle``, use version 5.0.1.
.. _`Oracle Database Server`: http://www.oracle.com/
.. _`cx_Oracle`: http://cx-oracle.sourceforge.net/
7 docs/topics/install.txt
View
@@ -82,9 +82,10 @@ installed.
wrapper in the standard library, so you don't need to install anything extra
in that case.
-* If you're using Oracle, you'll need a 4.X release of cx_Oracle_, version
- 4.3.1 or higher. You will also want to read the database-specific notes for
- the :ref:`Oracle backend <oracle-notes>`.
+* If you're using Oracle, you'll need a copy of cx_Oracle_, but please
+ read the database-specific notes for the
+ :ref:`Oracle backend <oracle-notes>` for important information
+ regarding supported versions of both Oracle and ``cx_Oracle``.
If you plan to use Django's ``manage.py syncdb`` command to
automatically create database tables for your models, you'll need to
Please sign in to comment.
Something went wrong with that request. Please try again.