# HG changeset patch
# User Martin von Zweigbergk <martinvonz@google.com>
# Date 1602782907 25200
# Node ID 03690079d7ddd282432f50bc43b08669609f4e91
# Parent  fbde66b05da4dca1cd21a876d3aad9c0a152d6f4
copy: clarify in help text that `hg co --forget` takes a *destination* file

We had a user who tried to pass a source file. The command then fails
with `<file>: not unmarking as copy - file is not marked as copied`,
so at least it's not just silent, but let's be a little clearer in the
documentation.

Differential Revision: https://phab.mercurial-scm.org/D9214

diff -r fbde66b05da4 -r 03690079d7dd mercurial/commands.py
--- a/mercurial/commands.py	Thu Oct 15 15:57:31 2020 +0200
+++ b/mercurial/commands.py	Thu Oct 15 10:28:27 2020 -0700
@@ -2328,7 +2328,7 @@
 @command(
     b'copy|cp',
     [
-        (b'', b'forget', None, _(b'unmark a file as copied')),
+        (b'', b'forget', None, _(b'unmark a destination file as copied')),
         (b'A', b'after', None, _(b'record a copy that has already occurred')),
         (
             b'',
@@ -2360,9 +2360,9 @@
     exist in the working directory. If invoked with -A/--after, the
     operation is recorded, but no copying is performed.
 
-    To undo marking a file as copied, use --forget. With that option,
-    all given (positional) arguments are unmarked as copies. The destination
-    file(s) will be left in place (still tracked).
+    To undo marking a destination file as copied, use --forget. With that
+    option, all given (positional) arguments are unmarked as copies. The
+    destination file(s) will be left in place (still tracked).
 
     This command takes effect with the next commit by default.