[#810, !471] fixed sphinx docs

doc/sphinx/api/cache-get-by-id.json

@@ -9,13 +9,14 @@
         "    \"arguments\": {",
         "        \"hw-address\": \"01:02:03:04:05:06\"",
         "    }"
+        "}"
     ],
     "hook": "host_cache",
     "name": "cache-get-by-id",
     "resp-syntax": [
         "{",
-        "    \"result\": 0",
+        "    \"result\": 0,",
-        "    \"text\": \"2 entries returned.\"",
+        "    \"text\": \"2 entries returned.\",",
         "    \"arguments\": <list of host reservations>",
         "}"
     ],
@@ -23,4 +24,4 @@
         "kea-dhcp4",
         "kea-dhcp6"
     ]
-}
+}

doc/sphinx/api/cache-get.json

@@ -7,8 +7,8 @@
     "name": "cache-get",
     "resp-syntax": [
         "{",
-        "    \"result\": 0",
+        "    \"result\": 0,",
-        "    \"text\": \"123 entries returned.\"",
+        "    \"text\": \"123 entries returned.\",",
         "    \"arguments\": <list of host reservations>",
         "}"
     ],
@@ -16,4 +16,4 @@
         "kea-dhcp4",
         "kea-dhcp6"
     ]
-}
+}

doc/sphinx/api/cache-insert.json

@@ -49,4 +49,4 @@
         "kea-dhcp4",
         "kea-dhcp6"
     ]
-}
+}

doc/sphinx/api/cache-size.json

@@ -7,8 +7,8 @@
     "name": "cache-size",
     "resp-syntax": [
         "{",
-        "    \"result\": 0",
+        "    \"result\": 0,",
-        "    \"text\": \"123 entries.\"",
+        "    \"text\": \"123 entries.\",",
         "    \"arguments\": { \"size\": 123 }",
         "}"
     ],
@@ -16,4 +16,4 @@
         "kea-dhcp4",
         "kea-dhcp6"
     ]
-}
+}

doc/sphinx/api/class-add.json

@@ -34,7 +34,7 @@
     "resp-syntax": [
         "{",
         "    \"result\": 0,",
-        "    \"text\": \"Class '<class-name>' added.\",",
+        "    \"text\": \"Class '<class-name>' added.\"",
         "}"
     ],
     "support": [

doc/sphinx/api/class-list.json

@@ -28,7 +28,7 @@
     "resp-syntax": [
         "{",
         "    \"result\": 0,",
-        "    \"text\": \"<number of> classes found\",",
+        "    \"text\": \"'<number of>' classes found\",",
         "    \"arguments\": {",
         "        \"client-classes\": [",
         "            {",

doc/sphinx/api/class-update.json

@@ -36,7 +36,7 @@
     "resp-syntax": [
         "{",
         "    \"result\": 0,",
-        "    \"text\": \"Class '<class-name>' updated.\",",
+        "    \"text\": \"Class '<class-name>' updated.\"",
         "}"
     ],
     "support": [

doc/sphinx/api/config-get.json

@@ -18,7 +18,7 @@
         "{",
         "    \"result\": <integer>,",
         "    \"arguments\": {",
-        "        <JSON configuration here, starting with Dhcp4, Dhcp6, or Control-agent object>",
+        "        <Dhcp4, Dhcp6, or Control-agent object>: <JSON configuration here> ",
         "    }",
         "}"
     ],

doc/sphinx/api/config-set.json

@@ -4,13 +4,13 @@
         "The config-set command instructs the server to replace its current configuration with the new configuration supplied in the command's arguments."
     ],
     "cmd-comment": [
-        "where `<server>` is the configuration element name for a given server such as \"Dhcp4\" or \"Dhcp6\""
+        "where '<server>' is the configuration element name for a given server such as \"Dhcp4\" or \"Dhcp6\""
     ],
     "cmd-syntax": [
         "{",
         "    \"command\": \"config-set\",",
         "    \"arguments\":  {",
-        "        \"<server>\": {",
+        "        \"'<server>'\": {",
         "        }",
         "     }",
         "}"
@@ -18,11 +18,11 @@
     "description": "See <xref linkend=\"command-config-set\"/>",
     "name": "config-set",
     "resp-syntax": [
-        "    {\"result\": 0, \"text\": \"Configuration successful.\" }",
+        "{\"result\": 0, \"text\": \"Configuration successful.\" }",
         "",
-        "    or",
+        "or",
         "",
-        "    {\"result\": 1, \"text\": \"unsupported parameter: BOGUS (<string>:16:26)\" }"
+        "{\"result\": 1, \"text\": \"unsupported parameter: BOGUS (<string>:16:26)\" }"
     ],
     "support": [
         "kea-dhcp4",

doc/sphinx/api/config-test.json

@@ -10,7 +10,7 @@
         "{",
         "    \"command\": \"config-test\",",
         "    \"arguments\":  {",
-        "        \"<server>\": {",
+        "        \"'<server>'\": {",
         "        }",
         "     }",
         "}"
@@ -20,7 +20,7 @@
     "resp-syntax": [
         "{ \"result\": 0, \"text\": \"Configuration seems sane...\" }",
         "",
-        "    or",
+        "or",
         "",
         "{ \"result\": 1, \"text\": \"unsupported parameter: BOGUS (<string>:16:26)\" }"
     ],

doc/sphinx/api/ha-heartbeat.json

@@ -6,7 +6,7 @@
     ],
     "cmd-syntax": [
         "{",
-        "    \"command\": \"ha-heartbeat\",",
+        "    \"command\": \"ha-heartbeat\"",
         "    }"
     ],
     "description": "See <xref linkend=\"ha-server-states\"/>",

doc/sphinx/api/ha-scopes.json

@@ -9,10 +9,11 @@
     "cmd-syntax": [
         "{",
         "    \"command\": \"ha-scopes\",",
-        "    \"service\": [ <service, typically \"dhcp4\" or \"dhcp6\"> ],",
+        "    \"service\": [ <service, typically 'dhcp4' or 'dhcp6'> ],",
         "    \"arguments\": {",
         "        \"scopes\": [ \"HA_server1\", \"HA_server2\" ]",
         "    }"
+        "}"
     ],
     "description": "See <xref linkend=\"command-ha-scopes\"/>",
     "hook": "high_availability",
@@ -21,4 +22,4 @@
         "kea-dhcp4",
         "kea-dhcp6"
     ]
-}
+}

doc/sphinx/api/ha-sync.json

@@ -7,7 +7,7 @@
     "cmd-syntax": [
         "{",
         "    \"command\": \"ha-sync\",",
-        "    \"service\": [ <service affected: \"dhcp4\" or \"dhcp6\" ],",
+        "    \"service\": [ <service affected: 'dhcp4' or 'dhcp6'> ],",
         "    \"arguments\": {",
         "        \"server-name\": <name of the partner server>,",
         "        \"max-period\": <integer, in seconds>",

doc/sphinx/api/lease4-add.json

@@ -21,4 +21,4 @@
     "support": [
         "kea-dhcp4"
     ]
-}
+}

doc/sphinx/api/lease4-get-all.json

@@ -8,7 +8,7 @@
     ],
     "cmd-syntax": [
         "{",
-        "    \"command\": \"lease4-get-all\"",
+        "    \"command\": \"lease4-get-all\",",
         "    \"arguments\": \"subnets\"",
         "}"
     ],
@@ -18,4 +18,4 @@
     "support": [
         "kea-dhcp4"
     ]
-}
+}

doc/sphinx/api/lease6-add.json

@@ -22,7 +22,7 @@
     "name": "lease6-add",
     "resp-syntax": [
         "{ \"result\": 0, \"text\": \"Lease added.\" }",
-        " or ",
+        "or",
         "{ \"result\": 1, \"text\": \"missing parameter 'ip-address' (<string>:3:19)\" }"
     ],
     "support": [

doc/sphinx/api/lease6-bulk-apply.json

@@ -48,7 +48,7 @@
         " {",
         "    {",
         "        \"result\": 0,",
-        "        \"text\": IPv6 leases bulk apply completed.",
+        "        \"text\": \"IPv6 leases bulk apply completed.\",",
         "        \"arguments\": {",
         "            \"failed-deleted-leases\": [",
         "                {",
@@ -62,7 +62,7 @@
         "                {",
         "                    \"ip-address\": \"2001:db8:cafe::\",",
         "                    \"type\": \"IA_PD\",",
-        "                    \"result\" <control result>,",
+        "                    \"result\": <control result>,",
         "                    \"error-message\": <error message>",
         "                }",
         "            ]",

doc/sphinx/api/network4-get.json

@@ -40,8 +40,8 @@
         "                    // many other subnet specific details here",
         "                },",
         "                {",
-        "                    \"id\": 6,",
         "                    \"subnet\": \"192.0.3.0/31\",",
+        "                    \"id\": 6,",
         "                    // many other subnet specific details here",
         "                }",
         "            ],",
@@ -54,4 +54,4 @@
     "support": [
         "kea-dhcp4"
     ]
-}
+}

doc/sphinx/api/network6-get.json

@@ -40,8 +40,8 @@
         "                    // many other subnet specific details here",
         "                },",
         "                {",
-        "                    \"id\": 6,",
         "                    \"subnet\": \"192.0.3.0/31\",",
+        "                    \"id\": 6,",
         "                    // many other subnet specific details here",
         "                }",
         "            ],",
@@ -54,4 +54,4 @@
     "support": [
         "kea-dhcp6"
     ]
-}
+}

doc/sphinx/api/remote-global-parameter4-set.json

@@ -8,7 +8,7 @@
     ],
     "cmd-syntax": [
         "{",
-        "    \"command\": \"remote-global-parameter4-set\"",
+        "    \"command\": \"remote-global-parameter4-set\",",
         "    \"arguments\": {",
         "        \"parameters\": {",
         "            <first parameter name>: <first parameter value>,",

doc/sphinx/api/remote-network4-del.json

@@ -15,7 +15,7 @@
         "                \"name\": <shared network name>",
         "            }",
         "        ],",
-        "        \"subnets-action\": \"keep\" | \"delete\",",
+        "        \"subnets-action\": '<'keep' | 'delete'>',",
         "        \"remote\": {",
         "            <specification of the database to connect to>",
         "        }",