diff --git a/Help/command/file.rst b/Help/command/file.rst
index 8a9f6e91f4..81f46aaf55 100644
--- a/Help/command/file.rst
+++ b/Help/command/file.rst
@@ -616,7 +616,9 @@ Filesystem
   emitted.
 
   Specifying ``COPY_ON_ERROR`` enables copying the file as a fallback if
-  creating the link fails.  It can be useful for handling situations such as
+  creating the link fails.  If the source is a directory, the destination
+  directory will be created if it does not exist, but no files will be copied
+  the from source one.  It can be useful for handling situations such as
   ``<original>`` and ``<linkname>`` being on different drives or mount points,
   which would make them unable to support a hard link.