Restyle Docs for new command dvc check-ignore

content/docs/command-reference/check-ignore.md

@@ -0,0 +1,85 @@
+# check-ignore
+
+Check whether any given files or directories are excluded from DVC due to the
+patterns found in [`.dvcignore`](/doc/user-guide/dvcignore).
+
+## Synopsis
+
+```usage
+usage: usage: dvc check-ignore [-h] [-q | -v] [-d] [-n]
+                               targets [targets ...]
+
+positional arguments:
+  targets        File or directory paths, or ignore patterns to check
+```
+
+## Description
+
+This helper command checks whether the given `targets` are ignored by DVC
+according to the [`.dvcignore` file](/doc/user-guide/dvcignore) (if any). The
+ones that are indeed ignores are printed back.
+
+## Options
+
+- `-d`, `--details` - show the exclude pattern together with each target path.
+
+- `-n`, `--non-matching` - show the target paths which don’t match any pattern.
+  Only usable when `--details` is also employed
+
+- `-h`, `--help` - prints the usage/help message, and exit.
+
+- `-q`, `--quiet` - do not write anything to standard output. Exit with 0 if no
+  problems arise, otherwise 1.
+
+- `-v`, `--verbose` - displays detailed tracing information.
+
+## Examples
+
+First, let's create a `.dvcignore` file with some patterns in it, and some files
+to check against it.
+
+```dvc
+$ echo "file*\n\!file2" >> .dvcignore
+$ cat .dvcignore
+file*
+!file2
+$ touch file1 file2 other
+$ ls
+file1  file2 other
+```
+
+Then, let's check if these files would be excluded given our `.dvcignore` file:
+
+```dvc
+$ dvc check-ignore file1
+file1
+$ dvc check-ignore file1 file2
+file1
+file2
+$ dvc check-ignore other
+  # There's no command output, meaning `other` is not excluded.
+$ dvc check-ignore file*
+file1
+file2
+```
+
+If the `--details` option is used, a series of lines are printed using this
+format: `<path/to/.dvcignore>:<line_num>:<pattern> | <target_path>`
+
+```dvc
+$ dvc check-ignore -d file1 file2
+.dvcignore:1:file*	file1
+.dvcignore:2:!file2	file2
+$ dvc check-ignore -d other
+$ dvc check-ignore -d file*
+.dvcignore:1:file*	file1
+.dvcignore:2:!file2	file2
+```
+
+With the `--non-matching` option, non-matching `targets` will also be included
+in the list. All fields in each line, except for `<target path>`, will be empty.
+
+```dvc
+$ dvc check-ignore -d -n other
+::	other
+```