From: Pádraig Brady <P@draigBrady.com>
Date: Sat, 13 Apr 2013 21:23:01 +0000 (+0100)
Subject: doc: mention caveats with using install --compare
X-Git-Tag: v8.22~161
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=c8ac385299950ba84eb8c33f7e32e4d85b18e3ff;p=thirdparty%2Fcoreutils.git

doc: mention caveats with using install --compare

* doc/coreutils.texi (install invocation): Mention that install(1) may
not correctly determine the default user or permissions for installed
files, and so is best used with options specifying these attributes.
---

diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index 8e4bacfb74..92917f17fa 100644
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -8920,6 +8920,12 @@ The program accepts the following options.  Also see @ref{Common options}.
 Compare each pair of source and destination files, and if the destination has
 identical content and any specified owner, group, permissions, and possibly
 SELinux context, then do not modify the destination at all.
+Note this option is best used in conjunction with @option{--user},
+@option{--group} and @option{--mode} options, lest @command{install}
+incorrectly determines the default attributes that installed files would have
+(as it doesn't consider setgid directories and POSIX default ACLs for example).
+This could result in redundant copies or attributes that are not reset to the
+correct defaults.
 
 @item -c
 @opindex -c