Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Browse code

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 authored July 17, 2005
7  docs/install.txt
@@ -29,6 +29,12 @@ If you plan to use Django's database API functionality, you'll need to
29 29
 make sure a database server is running. Django works with PostgreSQL_
30 30
 (recommended) or MySQL_.
31 31
 
  32
+Note that MySQL support is a recent development, and Django hasn't been
  33
+comprehensively tested with that database. If you find any bugs in Django's
  34
+MySQL bindings, please file them in `Django's ticket system`_ so we can fix them
  35
+immediately.
  36
+
  37
+
32 38
 Additionally, you'll need to make sure your Python database bindings are
33 39
 installed. If you're using PostgreSQL, you'll need the psycopg_
34 40
 package (version 1 -- not version 2, which is still in beta). If you're using
@@ -36,6 +42,7 @@ MySQL, you'll need MySQLdb_.
36 42
 
37 43
 .. _PostgreSQL: http://www.postgresql.org/
38 44
 .. _MySQL: http://www.mysql.com/
  45
+.. _`Django's ticket system: http://code.djangoproject.com/report/1
39 46
 .. _psycopg: http://initd.org/projects/psycopg1
40 47
 .. _MySQLdb: http://sourceforge.net/projects/mysql-python
41 48
 
4  docs/overview.txt
@@ -44,8 +44,8 @@ Install it
44 44
 
45 45
 Next, run the Django command-line utility. It'll create the database tables for
46 46
 you automatically, in the database specified in your Django settings. Django
47  
-works with PostgreSQL and MySQL, although other database adapters are on the
48  
-way::
  47
+works best with PostgreSQL, although we've recently added beta MySQL
  48
+support and other database adapters are on the way::
49 49
 
50 50
     django-admin.py install news
51 51
 
6  docs/tutorial01.txt
@@ -60,6 +60,11 @@ these settings to match your database's connection parameters:
60 60
 Do that with "``CREATE DATABASE database_name;``" within your database's
61 61
 interactive prompt.)
62 62
 
  63
+Also, note that MySQL support is a recent development, and Django hasn't been
  64
+comprehensively tested with that database. If you find any bugs in Django's
  65
+MySQL bindings, please file them in `Django's ticket system`_ so we can fix them
  66
+immediately.
  67
+
63 68
 Once you've done that, you need to tell Django which settings module you're
64 69
 currently using. Do that by setting an environment variable,
65 70
 ``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
88 93
 administrative stuff again.
89 94
 
90 95
 .. _`Python path`: http://docs.python.org/tut/node8.html#SECTION008110000000000000000
  96
+.. _`Django's ticket system: http://code.djangoproject.com/report/1
91 97
 
92 98
 Creating models
93 99
 ===============

0 notes on commit ad8e55d

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