From: Pádraig Brady <P@draigBrady.com>
Date: Sun, 31 Jul 2011 08:36:41 +0000 (+0100)
Subject: doc: mention the new mirroring behavior of cp -au
X-Git-Tag: v8.13~40
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=7eaff0fea3583d0ae7f8a6f6ccaf1c44f3ed4d3e;p=thirdparty%2Fcoreutils.git

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 c3aaa3dbfb..2e484979ea 100644
--- 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 b406a3cfb5..8ab70c1862 100644
--- 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