]> git.ipfire.org Git - thirdparty/coreutils.git/commitdiff
doc: clarify that cp --force may recreate files
authorPádraig Brady <P@draigBrady.com>
Sun, 10 Dec 2017 00:18:00 +0000 (16:18 -0800)
committerPádraig Brady <P@draigBrady.com>
Sun, 10 Dec 2017 00:18:00 +0000 (16:18 -0800)
* doc/coreutils.texi (cp invocation): The language used
to describe recreating the file was a little confusing
as it mentioned opening a removed file.
Fixes https://bugs.gnu.org/29315

doc/coreutils.texi

index 09730f6d3407ed43588e06686b97e0f9354b0363..ed3a63308ec5b42a93a1bbcbd3e156edd93e3c63 100644 (file)
@@ -8520,8 +8520,9 @@ Equivalent to @option{--no-dereference --preserve=links}.
 @opindex --force
 When copying without this option and an existing destination file cannot
 be opened for writing, the copy fails.  However, with @option{--force},
-when a destination file cannot be opened, @command{cp} then removes it and
-tries to open it again.  When this option is combined with
+when a destination file cannot be opened, @command{cp} then
+tries to recreate the file by first removing it.
+When this option is combined with
 @option{--link} (@option{-l}) or @option{--symbolic-link}
 (@option{-s}), the destination link is replaced, and unless
 @option{--backup} (@option{-b}) is also given there is no brief