Order migrate flags

Author: josevalim

lib/ecto/migrator.ex

@@ -209,6 +209,7 @@ defmodule Ecto.Migrator do
     * `:dynamic_repo` - the name of the Repo supervisor process.
       See `c:Ecto.Repo.put_dynamic_repo/1`.
     * `:strict_version_order` - abort when applying a migration with old timestamp
+      (otherwise it emits a warning)
   """
   @spec up(Ecto.Repo.t, integer, module, Keyword.t) :: :ok | :already_up
   def up(repo, version, module, opts \\ []) do

lib/mix/tasks/ecto.migrate.ex

@@ -68,35 +68,35 @@ defmodule Mix.Tasks.Ecto.Migrate do
 
   ## Command line options
 
-    * `-r`, `--repo` - the repo to migrate
-
     * `--all` - run all pending migrations
 
-    * `--step`, `-n` - run n number of pending migrations
+    * `--log-sql` - log the underlying sql statements for migrations
 
-    * `--to` - run all migrations up to and including version
+    * `--migrations-path` - the path to load the migrations from, defaults to
+      `"priv/repo/migrations"`. This option may be given multiple times in which
+      case the migrations are loaded from all the given directories and sorted
+      as if they were in the same one
 
-    * `--quiet` - do not log migration commands
+    * `--no-compile` - does not compile applications before migrating
 
-    * `--prefix` - the prefix to run migrations on
+    * `--no-deps-check` - does not check dependencies before migrating
 
-    * `--pool-size` - the pool size if the repository is started only for the task (defaults to 2)
+    * `--pool-size` - the pool size if the repository is started
+      only for the task (defaults to 2)
 
-    * `--log-sql` - log the raw sql migrations are running
+    * `--prefix` - the prefix to run migrations on
 
-    * `--strict-version-order` - abort when applying a migration with old timestamp
+    * `--quiet` - do not log migration commands
 
-    * `--no-compile` - does not compile applications before migrating
+    * `-r`, `--repo` - the repo to migrate
 
-    * `--no-deps-check` - does not check dependencies before migrating
+    * `--step`, `-n` - run n number of pending migrations
 
-    * `--migrations-path` - the path to load the migrations from, defaults to
-      `"priv/repo/migrations"`. This option may be given multiple times in which case the migrations
-      are loaded from all the given directories and sorted as if they were in the same one.
+    * `--strict-version-order` - abort when applying a migration with old
+      timestamp (otherwise it emits a warning)
+
+    * `--to` - run all migrations up to and including version
 
-      Note, if you have migrations paths e.g. `a/` and `b/`, and run
-      `mix ecto.migrate --migrations-path a/`, the latest migrations from `a/` will be run (even
-      if `b/` contains the overall latest migrations.)
   """
 
   @impl true

lib/mix/tasks/ecto.rollback.ex

@@ -64,33 +64,35 @@ defmodule Mix.Tasks.Ecto.Rollback do
 
   ## Command line options
 
-    * `-r`, `--repo` - the repo to rollback
+    * `--all` - run all pending migrations
 
-    * `--all` - revert all applied migrations
+    * `--log-sql` - log the underlying sql statements for migrations
 
-    * `--step`, `-n` - revert n number of applied migrations
+    * `--migrations-path` - the path to load the migrations from, defaults to
+      `"priv/repo/migrations"`. This option may be given multiple times in which
+      case the migrations are loaded from all the given directories and sorted
+      as if they were in the same one
 
-    * `--to` - revert all migrations down to and including version
+    * `--no-compile` - does not compile applications before migrating
 
-    * `--quiet` - do not log migration commands
+    * `--no-deps-check` - does not check dependencies before migrating
+
+    * `--pool-size` - the pool size if the repository is started
+      only for the task (defaults to 2)
 
     * `--prefix` - the prefix to run migrations on
 
-    * `--pool-size` - the pool size if the repository is started only for the task (defaults to 2)
+    * `--quiet` - do not log migration commands
 
-    * `--log-sql` - log the raw sql migrations are running
+    * `-r`, `--repo` - the repo to migrate
 
-    * `--no-compile` - does not compile applications before rolling back
+    * `--step`, `-n` - revert n migrations
 
-    * `--no-deps-check` - does not check dependencies before rolling back
+    * `--strict-version-order` - abort when applying a migration with old
+      timestamp (otherwise it emits a warning)
 
-    * `--migrations-path` - the path to load the migrations from, defaults to
-      `"priv/repo/migrations"`. This option may be given multiple times in which case the migrations
-      are loaded from all the given directories and sorted as if they were all in the same one.
+    * `--to` - revert all migrations down to and including version
 
-      Note, if you have migrations paths e.g. `a/` and `b/`, and run
-      `mix ecto.rollback --migrations-path a/`, only the latest migrations from `a/` will be
-      rolled back (even if `b/` contains the overall latest migrations.)
   """
 
   @impl true