From 7be01178a02c4878e0c8071e24c48b56bd6b04fc Mon Sep 17 00:00:00 2001
From: scivision <scivision@users.noreply.github.com>
Date: Fri, 24 Jan 2025 09:52:13 -0500
Subject: [PATCH] Help: JSON argument should be quoted

The error that results from a semicolon anywhere in a JSON string
is not obvious.

Issue: #26628
---
 Help/command/string.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/Help/command/string.rst b/Help/command/string.rst
index 7f56ac0c96..a2e1e28f84 100644
--- a/Help/command/string.rst
+++ b/Help/command/string.rst
@@ -523,6 +523,10 @@ Functionality for querying a JSON string.
   option is not present, a fatal error message is generated.  If no error
   occurs, the ``<error-variable>`` will be set to ``NOTFOUND``.
 
+In the following subcommands, the ``<json-string>`` argument should
+be written as a :ref:`Quoted Argument` to ensure the entire JSON
+string is passed as a single argument even if it contains semicolons.
+
 .. signature::
   string(JSON <out-var> [ERROR_VARIABLE <error-variable>]
          GET <json-string> <member|index> [<member|index> ...])