From 657e9be724d36b035295e1bb4f76d20f98bc7558 Mon Sep 17 00:00:00 2001
From: Alex Overchenko <aleksandr9809@gmail.com>
Date: Fri, 10 Oct 2025 08:42:59 +0300
Subject: [PATCH] file(CREATE_LINK): Document `COPY_ON_ERROR` behavior on
 directories

Issue: #27294
---
 Help/command/file.rst | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

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.