doc: cp: clarify behavior of the --preserve=xattr option

* doc/coreutils.texi (cp invocation): Enhance documentation
of the --preserve=xattr option regarding the preservation
of ACLs, SELinux contexts and capabilities: the user may
notice this only when not specifying --preserve=mode
and --preserve=context, too, i.e., otherwise, these attributes
are preserved anyway.

diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index 77f97a1..46d3680 100644 (file)
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -7838,7 +7838,8 @@ Preserve SELinux security context of the file, or fail with full diagnostics.
 Preserve extended attributes of the file, or fail with full diagnostics.
 If @command{cp} is built without xattr support, ignore this option.
 If SELinux context, ACLs or Capabilities are implemented using xattrs,
-they are preserved by this option as well.
+they are preserved implicitly by this option as well, i.e., even without
+specifying @option{--preserve=mode} or @option{--preserve=context}.
 @item all
 Preserve all file attributes.
 Equivalent to specifying all of the above, but with the difference