Skip to content

Commit

Permalink
cmd: add granularity example to status
Browse files Browse the repository at this point in the history
  • Loading branch information
jorgeorpinel committed Jul 11, 2020
1 parent 06fe612 commit a0292ef
Showing 1 changed file with 19 additions and 17 deletions.
36 changes: 19 additions & 17 deletions content/docs/command-reference/status.md
Original file line number Diff line number Diff line change
Expand Up @@ -137,7 +137,7 @@ workspace) is different from remote storage. Bringing the two into sync requires

- `-v`, `--verbose` - displays detailed tracing information.

## Example: Simple usage
## Examples

```dvc
$ dvc status
Expand All @@ -160,6 +160,24 @@ This shows that for stage `bar.dvc`, the dependency `foo` and the
<abbr>output</abbr> `bar` have changed. Likewise for `foo.dvc`, the dependency
`foo` has changed, but no output has changed.

## Example: Specific targets

`dvc status` supports granularity for files found in tracked directories, for
example:

```dvc
$ tree data
data
β”œβ”€β”€ raw
β”‚ β”œβ”€β”€ partition.1.dat
β”‚ β”œβ”€β”€ ...
β”‚ └── partition.n.dat
└── raw.dvc # data/raw/ is tracked as a whole.
$ dvc status -r local data/raw/partition.1.dat
new: data/raw
```

## Example: Dependencies

```dvc
Expand Down Expand Up @@ -202,22 +220,6 @@ new: data/matrix-test.p
The output shows where the location of the remote storage is, as well as any
differences between the <abbr>cache</abbr> and `storage` remote.

Note that `dvc status` supports granularity for files found in tracked
directories, for example:

```dvc
$ tree data
data
β”œβ”€β”€ raw
β”‚ β”œβ”€β”€ partition.1.dat
β”‚ β”œβ”€β”€ ...
β”‚ └── partition.n.dat
└── raw.dvc # data/raw/ is tracked as a whole.
$ dvc status -r local data/raw/partition.1.dat
new: data/raw
```

## Example: Import stage needs update

Let's import a data file (`data.csv`) from a different <abbr>DVC repository
Expand Down

0 comments on commit a0292ef

Please sign in to comment.