More options docs clean up

Author: josevalim

lib/ecto/migrator.ex

@@ -372,14 +372,13 @@ defmodule Ecto.Migrator do
   ## Options
 
     * `:all` - runs all available if `true`
+
     * `:step` - runs the specific number of migrations
+
     * `:to` - runs all until the supplied version is reached
-    * `:log` - the level to use for logging. Defaults to `:info`.
-      Can be any of `Logger.level/0` values or a boolean.
-    * `:prefix` - the prefix to run the migrations on
-    * `:dynamic_repo` - the name of the Repo supervisor process.
-      See `c:Ecto.Repo.put_dynamic_repo/1`.
+      (including the version given in `:to`)
 
+  Plus all other options described in `up/4`.
   """
   @spec run(Ecto.Repo.t, String.t | [String.t] | [{integer, module}], atom, Keyword.t) :: [integer]
   def run(repo, migration_source, direction, opts) do

lib/mix/tasks/ecto.migrations.ex

@@ -37,19 +37,21 @@ defmodule Mix.Tasks.Ecto.Migrations do
 
   ## Command line options
 
-    * `-r`, `--repo` - the repo to obtain the status for
+    * `--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.
+
+      Note, if you have previously run migrations from paths `a/` and `b/`, and now
+      run `mix ecto.migrations --migrations-path a/` (omitting path `b/`), the
+      migrations from the path `b/` will be shown in the output as `** FILE NOT FOUND **`.
 
     * `--no-compile` - does not compile applications before running
 
     * `--no-deps-check` - does not check dependencies before running
 
-    * `--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.
+    * `-r`, `--repo` - the repo to obtain the status for
 
-      Note, if you have previously run migrations from e.g. paths `a/` and `b/`, and now run `mix
-      ecto.migrations --migrations-path a/` (omitting path `b/`), the migrations from the path
-      `b/` will be shown in the output as `** FILE NOT FOUND **`.
   """
 
   @impl true