doc: clarify behaviour of mv for existing target directories

* doc/coreutils.texi (mv invocation): Add a sentence to clarify that
mv(1) will only replace empty directories in the target, and fail with
a diagnostic otherwise.  Discussed at:
http://lists.gnu.org/archive/html/coreutils/2015-12/msg00000.html

diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index a13c6e7be68af3e3bf528050c13bf11d239096aa..595cb9fe24ee85ab8159191e07235cbd7468e6be 100644 (file)
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -9094,6 +9094,9 @@ However, on other systems (at least FreeBSD 6.1 and Solaris 10) it silently
 renames not the symlink but rather the directory referenced by the symlink.
 @xref{Trailing slashes}.
 
+@emph{Note}: @command{mv} will only replace empty directories in the
+destination.  Conflicting populated directories are skipped with a diagnostic.
+
 The program accepts the following options.  Also see @ref{Common options}.
 
 @table @samp