diff options
| author | Tim Graham <timograham@gmail.com> | 2014-03-25 10:17:23 -0400 |
|---|---|---|
| committer | Tim Graham <timograham@gmail.com> | 2014-03-25 14:03:02 -0400 |
| commit | 7eaf329ad38ff7ea6b47f1b0a3c20ca7a5ad079b (patch) | |
| tree | ec335e9cc6eb4f0aa69a9263c3c1a69df2854a80 /docs/ref | |
| parent | d84beb3d9105300a94061dd94911a0c3cd9021d2 (diff) | |
[1.7.x] Fixed #22322 -- Fixed incorrect explanation of what managed=False does.
refs #14305.
Thanks Adrian Klaver for the report.
Backport of 9b7ba8af1b from master
Diffstat (limited to 'docs/ref')
| -rw-r--r-- | docs/ref/django-admin.txt | 15 |
1 files changed, 6 insertions, 9 deletions
diff --git a/docs/ref/django-admin.txt b/docs/ref/django-admin.txt index 2daca51382..c7e1ad9f49 100644 --- a/docs/ref/django-admin.txt +++ b/docs/ref/django-admin.txt @@ -350,15 +350,12 @@ needed. ``inspectdb`` works with PostgreSQL, MySQL and SQLite. Foreign-key detection only works in PostgreSQL and with certain types of MySQL tables. -If your plan is that your Django application(s) modify data (i.e. edit, remove -records and create new ones) in the existing database tables corresponding to -any of the introspected models then one of the manual review and edit steps -you need to perform on the resulting ``models.py`` file is to change the -Python declaration of each one of these models to specify it is a -:attr:`managed <django.db.models.Options.managed>` one. - -This serves as an explicit opt-in to give your nascent Django project write -access to your precious data on a model by model basis. +By default, ``inspectdb`` creates unmanaged models. That is, ``managed = False`` +in the model's ``Meta`` class tells Django not to manage each table's creation, +modification, and deletion. If you do want to allow Django to manage the +table's lifecycle, you'll need to change the +:attr:`~django.db.models.Options.managed` option to ``True`` (or simply remove +it because ``True`` is its default value). The :djadminopt:`--database` option may be used to specify the database to introspect. |
