summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorPádraig Brady <P@draigBrady.com>2012-04-12 12:47:30 +0100
committerPádraig Brady <P@draigBrady.com>2012-04-12 18:35:17 +0100
commit3d53e7fe1c31aa440cc9708c7c51db6b78c07653 (patch)
tree13fc2d863087f5a0e2664592aa4902308e6fb0f0 /doc
parent7e0ef7c035a4ef331dfd5019465ad00171a7b800 (diff)
downloadcoreutils-3d53e7fe1c31aa440cc9708c7c51db6b78c07653.tar.xz
cp: change --attributes-only to not truncate existing files
* src/copy.c (copy_reg): Don't truncate an existing file, to support copying attributes between existing files. The original use case only considered creating new files, and it would be a very unusual use case to be relying on the truncating behavior. * doc/coreutils.texi (cp invocation): Mention the non truncating behavior. * tests/cp/attr-existing: A new test to ensure O_TRUNC skipped. * tests/Makefile.am: Reference the new test. * NEWS: Mention the change in behavior.
Diffstat (limited to 'doc')
-rw-r--r--doc/coreutils.texi6
1 files changed, 3 insertions, 3 deletions
diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index 510abb903..1fbf05116 100644
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -7649,9 +7649,9 @@ Equivalent to @option{-dR --preserve=all} with the reduced diagnostics.
@itemx --attributes-only
@opindex --attributes-only
-Preserve the specified attributes of the original files in the copy,
-but do not copy any data. See the @option{--preserve} option for
-controlling which attributes to copy.
+Copy only the specified attributes of the source file to the destination.
+If the destination already exists, do not alter its contents.
+See the @option{--preserve} option for controlling which attributes to copy.
@item -b
@itemx @w{@kbd{--backup}[=@var{method}]}