import: add '--file' option (#1816)

* import: add '--file' option * minor: update syn to fit into single line Co-authored-by: Ivan Shcheklein <[email protected]>
iterative · Sep 27, 2020 · 3a80a8c · 3a80a8c
1 parent 11ca7bd
commit 3a80a8c
Showing 1 changed file with 8 additions and 1 deletion.
diff --git a/content/docs/command-reference/import.md b/content/docs/command-reference/import.md
@@ -10,7 +10,9 @@ the import.
 ## Synopsis
 
 ```usage
-usage: dvc import [-h] [-q | -v] [-o <path>] [--rev <commit>] url path
+usage: dvc import [-h] [-q | -v]
+                  [-o <path>] [--file <filename>] [--rev <commit>]
+                  url path
 
 positional arguments:
   url              Location of DVC or Git repository to download from
@@ -86,6 +88,11 @@ repo at `url`) are not supported.
   current working directory). Directories specified in the path must already
   exist, otherwise this command will fail.
 
+- `--file <filename>` - specify a path and/or file name for the `.dvc` file
+  created by this command (e.g. `--file stages/stage.dvc`). This overrides the
+  default file name: `<file>.dvc`, where `<file>` is the desired file name of
+  the imported data (`out`).
+
 - `--rev <commit>` - commit hash, branch or tag name, etc. (any
   [Git revision](https://git-scm.com/docs/revisions)) of the repository to
   download the file or directory from. The latest commit in `master` (tip of the