From 1f32d51dbbcb7806309258679c3c6f2637b3393c Mon Sep 17 00:00:00 2001
From: Tyler Yankee <tyler.yankee@kitware.com>
Date: Thu, 11 Jun 2026 13:47:24 -0400
Subject: [PATCH] Help/file: Reference curl documentation for error codes

Fixes: #27866
---
 Help/command/file.rst | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/Help/command/file.rst b/Help/command/file.rst
index 42b087161e..4b4bb487eb 100644
--- a/Help/command/file.rst
+++ b/Help/command/file.rst
@@ -764,10 +764,16 @@ Transfer
 
     ``STATUS <variable>``
       Store the resulting status of the operation in a variable.
-      The status is a ``;`` separated list of length 2.
+      The status is a
+      :ref:`semicolon-separated list <CMake Language Lists>` of length 2.
       The first element is the numeric return value for the operation,
       and the second element is a string value for the error.
-      A ``0`` numeric error means no error in the operation.
+      A ``0`` numeric error means no error in the operation (``CURLE_OK``).
+
+      The return value and description are produced directly from libcurl.
+      See the `libcurl documentation`_ on error codes for more information.
+
+    .. _`libcurl documentation`: https://curl.se/libcurl/c/libcurl-errors.html
 
     ``TIMEOUT <seconds>``
       Terminate the operation after a given total time has elapsed.