From 58fad7f9fdf7ae15d0ac7393b813a3df57760b81 Mon Sep 17 00:00:00 2001 From: Jacob Kaplan-Moss Date: Wed, 3 Sep 2008 23:10:07 +0000 Subject: [PATCH] Added the last notes about 1.0, including the inevitable (short!) list of known issues. git-svn-id: http://code.djangoproject.com/svn/django/trunk@8959 bcc190cf-cafb-0310-a4f2-bffc1f526a37 --- docs/ref/databases.txt | 3 ++- docs/releases/1.0.txt | 36 +++++++++++++++++++++++++++++++++--- 2 files changed, 35 insertions(+), 4 deletions(-) diff --git a/docs/ref/databases.txt b/docs/ref/databases.txt index d4c4a25189..0dce7eabc9 100644 --- a/docs/ref/databases.txt +++ b/docs/ref/databases.txt @@ -13,6 +13,8 @@ This file describes some of the features that might be relevant to Django usage. Of course, it is not intended as a replacement for server-specific documentation or reference manuals. +.. _mysql-notes: + MySQL notes =========== @@ -240,7 +242,6 @@ matter unless you're printing out the field values and are expecting to see .. _sqlite-notes: - SQLite notes ============ diff --git a/docs/releases/1.0.txt b/docs/releases/1.0.txt index db3e9bf3cc..c3186f799c 100644 --- a/docs/releases/1.0.txt +++ b/docs/releases/1.0.txt @@ -212,7 +212,37 @@ replaced by ``ModelForm``) and a number of deprecated features which were replaced by the dispatcher, file-uploading and file-storage refactorings introduced in the Django 1.0 alpha releases. -Thanks -====== +Known issues +============ + +We've done our best to make Django 1.0 as solid as possible, but unfortunately +there are a couple of issues that we know about in the release. + +Multi-table model inheritance with ``to_field`` +----------------------------------------------- + +If you're using :ref:`multiple table model inheritance +`, be aware of this caveat: child models using a custom +``parent_link`` and ``to_field`` will cause database integrity errors. A set of +models like the following are **not valid**:: + + class Parent(models.Model): + name = models.CharField(max_length=10) + other_value = models.IntegerField(unique=True) + + class Child(Parent): + father = models.OneToOneField(Parent, primary_key=True, to_field="other_value", parent_link=True) + value = models.IntegerField() + +This bug will be fixed in the next release of Django. + +Caveats with support of certain databases +----------------------------------------- + +Django attempts to support as many features as possible on all database +backends. However, not all database backends are alike, and in particular many of the supported database differ greatly from version to version. It's a good idea to checkout our :ref:`notes on supported database `: + + - :ref:`mysql-notes` + - :ref:`sqlite-notes` + - :ref:`oracle-notes` -So many people. Really. \ No newline at end of file