summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorPádraig Brady <P@draigBrady.com>2013-04-13 22:23:01 +0100
committerPádraig Brady <P@draigBrady.com>2013-04-14 01:03:41 +0100
commitc8ac385299950ba84eb8c33f7e32e4d85b18e3ff (patch)
treee325caa1ff681dba800fef38d595dbd7158ccba4
parent1fe218888aace1703f78e0af0059d7a15485bf7f (diff)
downloadcoreutils-c8ac385299950ba84eb8c33f7e32e4d85b18e3ff.tar.xz
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.
-rw-r--r--doc/coreutils.texi6
1 files changed, 6 insertions, 0 deletions
diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index 8e4bacfb7..92917f17f 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