doc: mention the new mirroring behavior of cp -au

* NEWS: Mention the change in behavior.
* doc/coreutils.texi (cp invocation): Likewise.

diff --git a/NEWS b/NEWS
index c3aaa3dbfbd5c000d574c5dbf4efb696054eabae..2e484979ea7939c0a4deb7aa8f0b0ddfed1a506a 100644 (file)
--- a/NEWS
+++ b/NEWS
@@ -37,6 +37,9 @@ GNU coreutils NEWS                                    -*- outline -*-
   chmod, chown and chgrp now output the original attributes in messages,
   when -v or -c specified.
 
+  cp -au (where --preserve=links is implicit) may now replace newer
+  files in the destination, to mirror hard links from the source.
+
 ** New features
 
   md5sum accepts the new --strict option.  With --check, it makes the

diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index b406a3cfb5d857c3a818b767064bc9b951e2f84e..8ab70c1862bc45dd0c1f072a06bc74f50fd512fb 100644 (file)
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -7954,8 +7954,11 @@ same or newer modification time.  If time stamps are being preserved,
 the comparison is to the source time stamp truncated to the
 resolutions of the destination file system and of the system calls
 used to update time stamps; this avoids duplicate work if several
-@samp{cp -pu} commands are executed with the same source and
-destination.
+@samp{cp -pu} commands are executed with the same source and destination.
+If @option{--preserve=links} is also specified (like with @samp{cp -au}
+for example), that will take precedence.  Consequently, depending on the
+order that files are processed from the source, newer files in the destination
+may be replaced, to mirror hard links in the source.
 
 @item -v
 @itemx --verbose