From 19606ba211c5fc67a02baf7403d46c22fe70297a Mon Sep 17 00:00:00 2001
From: Jorge Orpinel <jorgeorpinel@users.noreply.github.com>
Date: Mon, 4 Jan 2021 01:16:12 -0600
Subject: [PATCH] dvc: std/update --tragets options (#5193)

to match iterative/dvc.org/pull/2062
---
 dvc/command/diff.py    |  3 ++-
 dvc/command/metrics.py |  7 +++++--
 dvc/command/params.py  |  8 ++++++--
 dvc/command/plots.py   | 10 ++++++----
 4 files changed, 19 insertions(+), 9 deletions(-)

diff --git a/dvc/command/diff.py b/dvc/command/diff.py
index 6fd64e67da..68e2c8c8d1 100644
--- a/dvc/command/diff.py
+++ b/dvc/command/diff.py
@@ -174,9 +174,10 @@ def add_parser(subparsers, parent_parser):
         "--targets",
         nargs="*",
         help=(
-            "Limit command scope to these tracked files or directories. "
+            "Specific DVC-tracked files to compare. "
             "Accepts one or more file paths."
         ),
+        metavar="<paths>",
     ).complete = completion.FILE
     diff_parser.add_argument(
         "a_rev",
diff --git a/dvc/command/metrics.py b/dvc/command/metrics.py
index 30c5b019a1..04a663de9e 100644
--- a/dvc/command/metrics.py
+++ b/dvc/command/metrics.py
@@ -280,8 +280,11 @@ def add_parser(subparsers, parent_parser):
         "--targets",
         nargs="*",
         help=(
-            "Limit command scope to these metrics files. Using -R, "
-            "directories to search metrics files in can also be given."
+            "Specific metrics file(s) to compare "
+            "(even if not found as `metrics` in `dvc.yaml`). "
+            "Using -R, directories to search metrics files in "
+            "can also be given."
+            "Shows all tracked metrics by default.",
         ),
         metavar="<paths>",
     ).complete = completion.FILE
diff --git a/dvc/command/params.py b/dvc/command/params.py
index 88a41204d3..fec3ef8eb1 100644
--- a/dvc/command/params.py
+++ b/dvc/command/params.py
@@ -98,8 +98,12 @@ def add_parser(subparsers, parent_parser):
     params_diff_parser.add_argument(
         "--targets",
         nargs="*",
-        help="Limit command scope to these params files.",
-        metavar="<path>",
+        help=(
+            "Specific params file(s) to compare "
+            "(even if not found as `params` in `dvc.yaml`). "
+            "Shows all tracked params by default.",
+        ),
+        metavar="<paths>",
     ).complete = completion.FILE
     params_diff_parser.add_argument(
         "--all",
diff --git a/dvc/command/plots.py b/dvc/command/plots.py
index 27ffd16f24..ef55b3298c 100644
--- a/dvc/command/plots.py
+++ b/dvc/command/plots.py
@@ -158,10 +158,12 @@ def add_parser(subparsers, parent_parser):
     plots_diff_parser.add_argument(
         "--targets",
         nargs="*",
-        help="Files to visualize (supports any file, "
-        "even when not found as `plots` in `dvc.yaml`). "
-        "Shows all plots by default.",
-        metavar="<path>",
+        help=(
+            "Specific plots file(s) to visualize "
+            "(even if not found as `plots` in `dvc.yaml`). "
+            "Shows all tracked plots by default.",
+        ),
+        metavar="<paths>",
     ).complete = completion.FILE
     plots_diff_parser.add_argument(
         "-e",