Changeset 5692

Timestamp:

07/14/07 00:27:22 (1 year ago)

Author:

mtredinnick

Message:

Fixed #4869 -- Added a note that syncdb does not alter existing tables. Thanks,
James Bennett.

Files:

• django/trunk/docs/django-admin.txt (modified) (1 diff)

django/trunk/docs/django-admin.txt

@@ -401 +401 @@
-this command to install the default apps.
-
+.. admonition:: Syncdb will not alter existing tables
+
+   ``syncdb`` will only create tables for models which have not yet been
+   installed. It will *never* issue ``ALTER TABLE`` statements to match
+   changes made to a model class after installation. Changes to model classes
+   and database schemas often involve some form of ambiguity and, in those
+   cases, Django would have to guess at the correct changes to make. There is
+   a risk that critical data would be lost in the process.
+
+   If you have made changes to a model and wish to alter the database tables
+   to match, use the ``sql`` command to display the new SQL structure and
+   compare that to your existing table schema to work out the changes.
+
-If you're installing the ``django.contrib.auth`` application, ``syncdb`` will
-give you the option of creating a superuser immediately.