From 9b56aabd99d7412777ef8182bae2298e922d22b5 Mon Sep 17 00:00:00 2001
From: scivision <scivision@users.noreply.github.com>
Date: Fri, 24 Feb 2023 09:59:06 -0500
Subject: Help:file: document HTTPHEADER more

Some servers have allow-lists for HTTP UserAgent for example.
CMake project devs would benefit from this hint about setting
authorization tokens and HTTP User Agent.
---
 Help/command/file.rst | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/Help/command/file.rst b/Help/command/file.rst
index df895d0..6ab7421 100644
--- a/Help/command/file.rst
+++ b/Help/command/file.rst
@@ -1077,7 +1077,14 @@ Options to both ``DOWNLOAD`` and ``UPLOAD`` are:
 ``HTTPHEADER <HTTP-header>``
   .. versionadded:: 3.7
 
-  HTTP header for operation. Suboption can be repeated several times.
+  HTTP header for ``DOWNLOAD`` and ``UPLOAD`` operations. ``HTTPHEADER`` can be
+  repeated for multiple options:
+
+  .. code-block:: cmake
+
+    file(DOWNLOAD <url>
+         HTTPHEADER "Authorization: Bearer <auth-token>"
+         HTTPHEADER "UserAgent: Mozilla/5.0")
 
 ``NETRC <level>``
   .. versionadded:: 3.11
-- 
cgit v0.12