Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
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
@adrianholovaty 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
View
7 docs/install.txt
@@ -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
View
4 docs/overview.txt
@@ -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
View
6 docs/tutorial01.txt
@@ -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
===============

0 comments on commit ad8e55d

Please sign in to comment.
Something went wrong with that request. Please try again.