Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Browse files

Added notes to documentation that MySQL support has not been comprehe…

…nsively tested. Thanks, Simon!

git-svn-id: http://code.djangoproject.com/svn/django/trunk@148 bcc190cf-cafb-0310-a4f2-bffc1f526a37
  • Loading branch information...
commit ad8e55db9b0856573bfe740c350bfb39c7ca388e 1 parent aef7519
Adrian Holovaty adrianholovaty authored
Showing with 15 additions and 2 deletions.
  1. +7 −0 docs/install.txt
  2. +2 −2 docs/overview.txt
  3. +6 −0 docs/tutorial01.txt
7 docs/install.txt
View
@@ -29,6 +29,12 @@ If you plan to use Django's database API functionality, you'll need to
make sure a database server is running. Django works with PostgreSQL_
(recommended) or MySQL_.
+Note that MySQL support is a recent development, and Django hasn't been
+comprehensively tested with that database. If you find any bugs in Django's
+MySQL bindings, please file them in `Django's ticket system`_ so we can fix them
+immediately.
+
+
Additionally, you'll need to make sure your Python database bindings are
installed. If you're using PostgreSQL, you'll need the psycopg_
package (version 1 -- not version 2, which is still in beta). If you're using
@@ -36,6 +42,7 @@ MySQL, you'll need MySQLdb_.
.. _PostgreSQL: http://www.postgresql.org/
.. _MySQL: http://www.mysql.com/
+.. _`Django's ticket system: http://code.djangoproject.com/report/1
.. _psycopg: http://initd.org/projects/psycopg1
.. _MySQLdb: http://sourceforge.net/projects/mysql-python
4 docs/overview.txt
View
@@ -44,8 +44,8 @@ Install it
Next, run the Django command-line utility. It'll create the database tables for
you automatically, in the database specified in your Django settings. Django
-works with PostgreSQL and MySQL, although other database adapters are on the
-way::
+works best with PostgreSQL, although we've recently added beta MySQL
+support and other database adapters are on the way::
django-admin.py install news
6 docs/tutorial01.txt
View
@@ -60,6 +60,11 @@ these settings to match your database's connection parameters:
Do that with "``CREATE DATABASE database_name;``" within your database's
interactive prompt.)
+Also, note that MySQL support is a recent development, and Django hasn't been
+comprehensively tested with that database. If you find any bugs in Django's
+MySQL bindings, please file them in `Django's ticket system`_ so we can fix them
+immediately.
+
Once you've done that, you need to tell Django which settings module you're
currently using. Do that by setting an environment variable,
``DJANGO_SETTINGS_MODULE``. Here's how you do that in the Bash shell on Unix::
@@ -88,6 +93,7 @@ Now you're set to start doing work. You won't have to take care of this boring
administrative stuff again.
.. _`Python path`: http://docs.python.org/tut/node8.html#SECTION008110000000000000000
+.. _`Django's ticket system: http://code.djangoproject.com/report/1
Creating models
===============
Please sign in to comment.
Something went wrong with that request. Please try again.