From 32fefc6f70c529ee5f13b2d82a26333fb7a4ed14 Mon Sep 17 00:00:00 2001 From: Andrew Godwin Date: Sun, 6 Jul 2014 00:30:05 -0700 Subject: [PATCH] Document --fake and --list on migrate command --- docs/ref/django-admin.txt | 24 +++++++++++++++++++++++- 1 file changed, 23 insertions(+), 1 deletion(-) diff --git a/docs/ref/django-admin.txt b/docs/ref/django-admin.txt index f47c1967cd6..e67276613a6 100644 --- a/docs/ref/django-admin.txt +++ b/docs/ref/django-admin.txt @@ -694,7 +694,29 @@ The behavior of this command changes depending on the arguments provided: * `` ``: Brings the database schema to a state where it would have just run the given migration, but no further - this may involve unapplying migrations if you have previously migrated past the named - migration. Use the name `zero` to unapply all migrations for an app. + migration. Use the name ``zero`` to unapply all migrations for an app. + +.. django-admin-option:: --fake + +The ``--fake`` option tells Django to mark the migrations as having been +applied or unapplied, but without actually running the SQL to change your +database schema. + +This is intended for advanced users to manipulate the +current migration state directly if they're manually applying changes; +be warned that using ``--fake`` runs the risk of putting the migration state +table into a state where manual recovery will be needed to make migrations +run correctly. + +.. django-admin-option:: --list + +The ``--list`` option will list all of the apps Django knows about, the +migrations available for each app and if they are applied or not (marked by +an ``[X]`` next to the migration name). + +Apps without migrations are also included in the list, but will have +``(no migrations)`` printed under them. + runfcgi [options] -----------------