Skip to content

Commit

Permalink
cmd ref: improve explanation about repeated run commands
Browse files Browse the repository at this point in the history
  • Loading branch information
jorgeorpinel committed Feb 28, 2020
1 parent 5c4f9b9 commit 46eb055
Showing 1 changed file with 7 additions and 7 deletions.
14 changes: 7 additions & 7 deletions public/static/docs/command-reference/run.md
Original file line number Diff line number Diff line change
Expand Up @@ -46,9 +46,9 @@ the first output (`-o`, `-O`, `-m`, or `-M` option). If neither `-f` nor outputs
are specified, the file name defaults to `Dvcfile`.

Note that `dvc run` executes the given `command` in order to check it's validity
and to write the defined outputs, unless an equivalent stage file exists (same
dependencies, outputs, and `command` to execute) that has already been run and
is up to date.
and to write the defined outputs, unless the same `dvc run` command has already
been run in this workspace (meaning an identical stage file already exists, and
its outputs correspond to the stored file hash values).

Note that `dvc repro` provides an interface to check state and reproduce this
graph (pipeline) later. This concept is similar to the one of the
Expand Down Expand Up @@ -144,10 +144,10 @@ data pipeline (e.g. random numbers, time functions, hardware dependency, etc.)
determined by the logic described in the `-f` option) without asking for
confirmation.

- `--ignore-build-cache` - forcefully execute the `command` again, even if an
equivalent stage file exists. Useful if the command's code is
non-deterministic (meaning it produces different outputs from the same list of
inputs).
- `--ignore-build-cache` - forcefully execute the `command` again, even if the
same `dvc run` command has already been run in this workspace. Useful if the
command's code is non-deterministic (meaning it produces different outputs
from the same list of inputs).

- `--remove-outs` (_deprecated_) - remove stage outputs before executing the
`command`. If `--no-exec` specified outputs are removed anyway. See
Expand Down

0 comments on commit 46eb055

Please sign in to comment.