From 6c0f37546f2264241d36866a213c5b37abea58b8 Mon Sep 17 00:00:00 2001
From: Brad King <brad.king@kitware.com>
Date: Mon, 17 Nov 2025 15:56:38 -0500
Subject: Help: Improve string(JSON) synopsis document source readability

Avoid spaces in signature target names.
---
 Help/command/string.rst | 22 +++++++++++-----------
 1 file changed, 11 insertions(+), 11 deletions(-)

diff --git a/Help/command/string.rst b/Help/command/string.rst
index 6bd56a1..3cb3567 100644
--- a/Help/command/string.rst
+++ b/Help/command/string.rst
@@ -45,16 +45,16 @@ Synopsis
 
   `JSON`_
     string(JSON <out-var> [ERROR_VARIABLE <error-var>]
-           {`GET <JSON GET_>`_ | `TYPE <JSON TYPE_>`_ | `LENGTH <JSON LENGTH_>`_ | `REMOVE <JSON REMOVE_>`_}
+           {`GET <JSON-GET_>`_ | `TYPE <JSON-TYPE_>`_ | `LENGTH <JSON-LENGTH_>`_ | `REMOVE <JSON-REMOVE_>`_}
            <json-string> <member|index> [<member|index> ...])
     string(JSON <out-var> [ERROR_VARIABLE <error-var>]
-           `MEMBER <JSON MEMBER_>`_ <json-string>
+           `MEMBER <JSON-MEMBER_>`_ <json-string>
            [<member|index> ...] <index>)
     string(JSON <out-var> [ERROR_VARIABLE <error-var>]
-           `SET <JSON SET_>`_ <json-string>
+           `SET <JSON-SET_>`_ <json-string>
            <member|index> [<member|index> ...] <value>)
     string(JSON <out-var> [ERROR_VARIABLE <error-var>]
-           `EQUAL <JSON EQUAL_>`_ <json-string1> <json-string2>)
+           `EQUAL <JSON-EQUAL_>`_ <json-string1> <json-string2>)
 
 Search and Replace
 ^^^^^^^^^^^^^^^^^^
@@ -522,7 +522,7 @@ Functionality for querying a JSON string.
 .. signature::
   string(JSON <out-var> [ERROR_VARIABLE <error-variable>]
          GET <json-string> <member|index> [<member|index> ...])
-  :target: JSON GET
+  :target: JSON-GET
 
   Get an element from ``<json-string>`` at the location given
   by the list of ``<member|index>`` arguments.
@@ -534,7 +534,7 @@ Functionality for querying a JSON string.
 .. signature::
   string(JSON <out-var> [ERROR_VARIABLE <error-variable>]
          TYPE <json-string> <member|index> [<member|index> ...])
-  :target: JSON TYPE
+  :target: JSON-TYPE
 
   Get the type of an element in ``<json-string>`` at the location
   given by the list of ``<member|index>`` arguments. The ``<out-var>``
@@ -545,7 +545,7 @@ Functionality for querying a JSON string.
   string(JSON <out-var> [ERROR_VARIABLE <error-var>]
          MEMBER <json-string>
          [<member|index> ...] <index>)
-  :target: JSON MEMBER
+  :target: JSON-MEMBER
 
   Get the name of the ``<index>``-th member in ``<json-string>``
   at the location given by the list of ``<member|index>`` arguments.
@@ -554,7 +554,7 @@ Functionality for querying a JSON string.
 .. signature::
   string(JSON <out-var> [ERROR_VARIABLE <error-variable>]
          LENGTH <json-string> [<member|index> ...])
-  :target: JSON LENGTH
+  :target: JSON-LENGTH
 
   Get the length of an element in ``<json-string>`` at the location
   given by the list of ``<member|index>`` arguments.
@@ -563,7 +563,7 @@ Functionality for querying a JSON string.
 .. signature::
   string(JSON <out-var> [ERROR_VARIABLE <error-variable>]
          REMOVE <json-string> <member|index> [<member|index> ...])
-  :target: JSON REMOVE
+  :target: JSON-REMOVE
 
   Remove an element from ``<json-string>`` at the location
   given by the list of ``<member|index>`` arguments. The JSON string
@@ -572,7 +572,7 @@ Functionality for querying a JSON string.
 .. signature::
   string(JSON <out-var> [ERROR_VARIABLE <error-variable>]
          SET <json-string> <member|index> [<member|index> ...] <value>)
-  :target: JSON SET
+  :target: JSON-SET
 
   Set an element in ``<json-string>`` at the location
   given by the list of ``<member|index>`` arguments to ``<value>``.
@@ -584,7 +584,7 @@ Functionality for querying a JSON string.
 .. signature::
   string(JSON <out-var> [ERROR_VARIABLE <error-var>]
          EQUAL <json-string1> <json-string2>)
-  :target: JSON EQUAL
+  :target: JSON-EQUAL
 
   Compare the two JSON objects given by ``<json-string1>``
   and ``<json-string2>`` for equality.  The contents of ``<json-string1>``
-- 
cgit v0.12


From 510d81c7bc51472a22acb936cfbb4d1717c3a855 Mon Sep 17 00:00:00 2001
From: Brad King <brad.king@kitware.com>
Date: Mon, 17 Nov 2025 16:00:09 -0500
Subject: Help: Avoid reST named references in string(JSON) synopsis

Also revert commit 9702a01dc9 (Help: string(LENGTH): Fix synopsis link
to command description, 2023-12-30, v3.28.2~23^2).  It was only needed
to avoid re-using a named reference that we've now removed.

Issue: #25546
---
 Help/command/string.rst | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/Help/command/string.rst b/Help/command/string.rst
index 3cb3567..89c109a 100644
--- a/Help/command/string.rst
+++ b/Help/command/string.rst
@@ -22,7 +22,7 @@ Synopsis
     string(`JOIN`_ <glue> <out-var> [<input>...])
     string(`TOLOWER`_ <string> <out-var>)
     string(`TOUPPER`_ <string> <out-var>)
-    string(`LENGTH <LENGTH_>`_ <string> <out-var>)
+    string(`LENGTH`_ <string> <out-var>)
     string(`SUBSTRING`_ <string> <begin> <length> <out-var>)
     string(`STRIP`_ <string> <out-var>)
     string(`GENEX_STRIP`_ <string> <out-var>)
@@ -45,16 +45,16 @@ Synopsis
 
   `JSON`_
     string(JSON <out-var> [ERROR_VARIABLE <error-var>]
-           {`GET <JSON-GET_>`_ | `TYPE <JSON-TYPE_>`_ | `LENGTH <JSON-LENGTH_>`_ | `REMOVE <JSON-REMOVE_>`_}
+           {`GET <JSON-GET_>`__ | `TYPE <JSON-TYPE_>`__ | `LENGTH <JSON-LENGTH_>`__ | `REMOVE <JSON-REMOVE_>`__}
            <json-string> <member|index> [<member|index> ...])
     string(JSON <out-var> [ERROR_VARIABLE <error-var>]
-           `MEMBER <JSON-MEMBER_>`_ <json-string>
+           `MEMBER <JSON-MEMBER_>`__ <json-string>
            [<member|index> ...] <index>)
     string(JSON <out-var> [ERROR_VARIABLE <error-var>]
-           `SET <JSON-SET_>`_ <json-string>
+           `SET <JSON-SET_>`__ <json-string>
            <member|index> [<member|index> ...] <value>)
     string(JSON <out-var> [ERROR_VARIABLE <error-var>]
-           `EQUAL <JSON-EQUAL_>`_ <json-string1> <json-string2>)
+           `EQUAL <JSON-EQUAL_>`__ <json-string1> <json-string2>)
 
 Search and Replace
 ^^^^^^^^^^^^^^^^^^
-- 
cgit v0.12