]> git.ipfire.org Git - thirdparty/kea.git/commitdiff
[#777,!464] Cosmetic improvments in .json files
authorTomek Mrugalski <tomasz@isc.org>
Tue, 6 Aug 2019 16:44:01 +0000 (18:44 +0200)
committerTomek Mrugalski <tomasz@isc.org>
Wed, 7 Aug 2019 10:58:10 +0000 (12:58 +0200)
19 files changed:
doc/sphinx/api/class-add.json
doc/sphinx/api/class-del.json
doc/sphinx/api/class-get.json
doc/sphinx/api/class-list.json
doc/sphinx/api/class-update.json
doc/sphinx/api/config-get.json
doc/sphinx/api/config-test.json
doc/sphinx/api/config-write.json
doc/sphinx/api/ha-heartbeat.json
doc/sphinx/api/ha-sync.json
doc/sphinx/api/lease4-wipe.json
doc/sphinx/api/lease6-add.json
doc/sphinx/api/lease6-bulk-apply.json
doc/sphinx/api/network6-del.json
doc/sphinx/api/reservation-add.json
doc/sphinx/api/shutdown.json
doc/sphinx/api/stat-lease4-get.json
doc/sphinx/api/stat-lease6-get.json
doc/sphinx/api/version-get.json

index 41fa4c30eb5c0c916a502b949629a8bf8e148cd2..611f1a490cb6b7fa04df5e681c7d63caa530ca44 100644 (file)
@@ -2,13 +2,11 @@
     "avail": "1.5.0",
     "brief": [
         "This command is used to create and add a new class to the existing",
-        "              server configuration."
+        "server configuration."
     ],
     "cmd-comment": [
-        "The <command>next-server</command>,",
-        "                    <command>server-hostname</command> and",
-        "                    <command>boot-file-name</command> are DHCPv4 specific. Only",
-        "                    one client class can be added with a single command. "
+        "The ``next-server``, ``server-hostname`` and ``boot-file-name`` are DHCPv4 specific. Only",
+        "one client class can be added with a single command. "
     ],
     "cmd-syntax": [
         "{",
@@ -31,7 +29,7 @@
     "name": "class-add",
     "resp-comment": [
         "The command will be successful (result 0), unless the",
-        "                     class name is a duplicate or another error occurs (result 1)."
+        "class name is a duplicate or another error occurs (result 1)."
     ],
     "resp-syntax": [
         "{",
@@ -43,4 +41,4 @@
         "kea-dhcp4",
         "kea-dhcp6"
     ]
-}
\ No newline at end of file
+}
index 1a57ace4568b7fb9cb4505740c25667366257f31..069952392abb8b92e54c8efe7d659f554c6f2024 100644 (file)
@@ -16,9 +16,9 @@
     "name": "class-del",
     "resp-comment": [
         "The command will return a result of 3 (empty) if the client",
-        "                    class doesn't exist. If the client class exists, the retured",
-        "                    result is 0 if the deletion was successful and the result is 1",
-        "                    if the deletion is unsuccessful."
+        "class doesn't exist. If the client class exists, the retured",
+        "result is 0 if the deletion was successful and the result is 1",
+        "if the deletion is unsuccessful."
     ],
     "resp-syntax": [
         "{",
@@ -30,4 +30,4 @@
         "kea-dhcp4",
         "kea-dhcp6"
     ]
-}
\ No newline at end of file
+}
index 57aa2a9a22dbdcf85eea90dab71fa589e68f2a46..00c9738d93ff78fca1680d3131be3f9a17fb3dc0 100644 (file)
@@ -2,7 +2,7 @@
     "avail": "1.5.0",
     "brief": [
         "This command is used to return detailed information about an",
-        "              existing client class."
+        "existing client class."
     ],
     "cmd-syntax": [
         "{",
     "name": "class-get",
     "resp-comment": [
         "The returned information depends on the DHCP server type,",
-        "                     i.e. some parameters are specific to DHCPv4 server. Also,",
-        "                     some parameters may not be returned if they are not set for",
-        "                     the client class. If the class with specified name doesn't",
-        "                     exist a result of 3 (empty) is returned. If the client class",
-        "                     is found, the result of 0 is returned. If there is an error",
-        "                     while processing the command, the result of 1 is returned."
+        "i.e. some parameters are specific to DHCPv4 server. Also,",
+        "some parameters may not be returned if they are not set for",
+        "the client class. If the class with specified name doesn't",
+        "exist a result of 3 (empty) is returned. If the client class",
+        "is found, the result of 0 is returned. If there is an error",
+        "while processing the command, the result of 1 is returned."
     ],
     "resp-syntax": [
         "{",
@@ -48,4 +48,4 @@
         "kea-dhcp4",
         "kea-dhcp6"
     ]
-}
\ No newline at end of file
+}
index 0f62b286c9481c5be99b5663305f3cfd9cb2c337..36486cbfd3bf83c8e876c08e0dd1d591f470a6ac 100644 (file)
@@ -2,7 +2,7 @@
     "avail": "1.5.0",
     "brief": [
         "This command is used to retrieve a list of all client",
-        "              classes from the server configuration."
+        "classes from the server configuration."
     ],
     "cmd-comment": [
         "This command includes no arguments."
     "name": "class-list",
     "resp-comment": [
         "The returned list of classes merely contains their names.",
-        "                     In order to retrieve full information about one of these",
-        "                     classes use <xref linkend=\"command-class-get\"/>.",
-        "                     The returned result is 3 (empty) if no classes are found.",
-        "                     If the command is processed successfully and the list of",
-        "                     client classes is not empty, the result of 0 is returned.",
-        "                     If there is an error while processing the command, the",
-        "                     result of 1 is returned."
+        "In order to retrieve full information about one of these",
+        "classes use :ref:`command-class-get`.",
+        "The returned result is 3 (empty) if no classes are found.",
+        "If the command is processed successfully and the list of",
+        "client classes is not empty, the result of 0 is returned.",
+        "If there is an error while processing the command, the",
+        "result of 1 is returned."
     ],
     "resp-syntax": [
         "{",
@@ -45,4 +45,4 @@
         "kea-dhcp4",
         "kea-dhcp6"
     ]
-}
\ No newline at end of file
+}
index 0c88c7fed6eef66687107a8525c0ab5ca09b9d61..dd8d67baf833722183938a42be18a5dc427a395d 100644 (file)
@@ -2,13 +2,11 @@
     "avail": "1.5.0",
     "brief": [
         "This command is used to update an existing client class in",
-        "              the server configuration."
+        "the server configuration."
     ],
     "cmd-comment": [
-        "The <command>next-server</command>,",
-        "                    <command>server-hostname</command> and",
-        "                    <command>boot-file-name</command> are DHCPv4 specific. Only",
-        "                    one client class can be updated with a single command. "
+        "The ``next-server``, ``server-hostname`` and ``boot-file-name`` are DHCPv4 specific. Only",
+        "one client class can be updated with a single command. "
     ],
     "cmd-syntax": [
         "{",
@@ -31,9 +29,9 @@
     "name": "class-update",
     "resp-comment": [
         "The command will return the result of 3 (empty) if the client",
-        "                    class doesn't exist. If the client class exists, the retured",
-        "                    result is 0 if the update was successful and the result is 1",
-        "                    if the update is unsuccessful."
+        "class doesn't exist. If the client class exists, the retured",
+        "result is 0 if the update was successful and the result is 1",
+        "if the update is unsuccessful."
     ],
     "resp-syntax": [
         "{",
@@ -45,4 +43,4 @@
         "kea-dhcp4",
         "kea-dhcp6"
     ]
-}
\ No newline at end of file
+}
index 436bb4202eefbf4fc8d0a7a4d727f1c736d56d1e..2bee41388ad9571e10a121958dbdafb9d4eb48b2 100644 (file)
@@ -2,8 +2,8 @@
     "avail": "1.2.0",
     "brief": [
         "Retrieves the current configuration used by the server. The configuration",
-        "              is roughtly equal to the configuration file, but includes additional",
-        "              changes made by other commands and due to parameters inheritance."
+        "is roughtly equal to the configuration file, but includes additional",
+        "changes made by other commands and due to parameters inheritance."
     ],
     "cmd-comment": [
         "This command takes no parameters."
@@ -28,4 +28,4 @@
         "kea-dhcp-ddns",
         "kea-ctrl-agent"
     ]
-}
\ No newline at end of file
+}
index 5f09d7caf5058229c9f638828be05943a2bd5166..6399ca2bfd2887896ec0e1afc8f28dc6b17da48d 100644 (file)
     "description": "See <xref linkend=\"command-config-test\"/>",
     "name": "config-test",
     "resp-syntax": [
-        "{\"result\": 0, \"text\": \"Configuration seems sane...\" }",
+        "{ \"result\": 0, \"text\": \"Configuration seems sane...\" }",
         "",
         "    or",
         "",
-        "    {\"result\": 1, \"text\": \"unsupported parameter: BOGUS (<string>:16:26)\" }"
+        "\"result\": 1, \"text\": \"unsupported parameter: BOGUS (<string>:16:26)\" }"
     ],
     "support": [
         "kea-dhcp4",
@@ -30,4 +30,4 @@
         "kea-dhcp-ddns",
         "kea-ctrl-agent"
     ]
-}
\ No newline at end of file
+}
index a723c43984b6b8cf84fb4f264b28f61da9402b31..490dc7d28d446ed04f7c4b11dc6a9dd8285ce88d 100644 (file)
@@ -2,7 +2,7 @@
     "avail": "1.2.0",
     "brief": [
         "The config-write command instructs the Kea server to write its",
-        "              current configuration to a file on disk."
+        "current configuration to a file on disk."
     ],
     "cmd-syntax": [
         "{",
@@ -20,4 +20,4 @@
         "kea-dhcp-ddns",
         "kea-ctrl-agent"
     ]
-}
\ No newline at end of file
+}
index 67ddc8777cb32a74fb132753f78907b93f6e0d0e..c1eed190e6719d938aade43bb307959000e5d552 100644 (file)
@@ -2,7 +2,7 @@
     "avail": "1.4.0",
     "brief": [
         "This command is sent internally by Kea partner when operating",
-        "              in High Availability (HA) mode. It will retrieve the server HA state and clock value."
+        "in High Availability (HA) mode. It will retrieve the server HA state and clock value."
     ],
     "cmd-syntax": [
         "{",
     "hook": "high_availability",
     "name": "ha-heartbeat",
     "resp-comment": [
-        "The response to this command is different from the typical command response. The response will include server state (see <xref linkend=\"ha-server-states\"/> plus the current clock value."
+        "The response to this command is different from the typical command response. The response will include server state (see :ref:`ha-server-states`) plus the current clock value."
     ],
     "support": [
         "kea-dhcp4",
         "kea-dhcp6"
     ]
-}
\ No newline at end of file
+}
index 92b5c48753991d9a6efd3e23795ef7fa132b9de6..52b34e40f547e56751952a9e79eae41aac9a182a 100644 (file)
@@ -2,7 +2,7 @@
     "avail": "1.4.0",
     "brief": [
         "The command is issued to instruct the server running in HA mode to ",
-        "              synchronize its local lease database with the selected peer."
+        "synchronize its local lease database with the selected peer."
     ],
     "cmd-syntax": [
         "{",
@@ -21,4 +21,4 @@
         "kea-dhcp4",
         "kea-dhcp6"
     ]
-}
\ No newline at end of file
+}
index 4dee711f6792bf250162f6d97043651c18d340dd..1685a6d1c96f766d00518e00cd6e8c237d19082f 100644 (file)
@@ -5,10 +5,10 @@
     ],
     "cmd-syntax": [
         "{",
-        "  \"command\": \"lease4-wipe\",",
-        "  \"arguments\": {",
-        "    \"subnet-id\": 44",
-        "  }",
+        "    \"command\": \"lease4-wipe\",",
+        "    \"arguments\": {",
+        "        \"subnet-id\": 44",
+        "    }",
         "}"
     ],
     "description": "See <xref linkend=\"idp63\"/>",
@@ -17,4 +17,4 @@
     "support": [
         "kea-dhcp4"
     ]
-}
\ No newline at end of file
+}
index 336ecdb8821ef9920cb6d1c02685f98107990c4f..a8fd13fe5863f0a36b9c02e264a46b2090d432bb 100644 (file)
     "name": "lease6-add",
     "resp-syntax": [
         "{ \"result\": 0, \"text\": \"Lease added.\" }",
-        "    { \"result\": 1, \"text\": \"missing parameter 'ip-address' (<string>:3:19)\" }"
+        " or ",
+        "{ \"result\": 1, \"text\": \"missing parameter 'ip-address' (<string>:3:19)\" }"
     ],
     "support": [
         "kea-dhcp6"
     ]
-}
\ No newline at end of file
+}
index 7797f5cd4d9c3c008376398e92b9a8ef2874bde9..7f0e42dd4782875c7d3c165c9dd78c4dcab895ab 100644 (file)
@@ -8,35 +8,35 @@
     ],
     "cmd-syntax": [
         "{",
-        "        \"command\": \"lease6-bulk-apply\",",
-        "        \"arguments\": {",
-        "            \"deleted-leases\": [",
-        "                {",
-        "                    \"ip-address\": \"2001:db8:abcd::\",",
-        "                    \"type\": \"IA_PD\",",
-        "                    ...",
-        "                },",
-        "                {",
-        "                    \"ip-address\": \"2001:db8:abcd::234\",",
-        "                    \"type\": \"IA_NA\",",
-        "                    ...",
-        "                }",
-        "            ],",
-        "            \"leases\": [",
-        "                {",
-        "                    \"subnet-id\": 66,",
-        "                    \"ip-address\": \"2001:db8:cafe::\",",
-        "                    \"type\": \"IA_PD\",",
-        "                    ...",
-        "                },",
-        "                {",
-        "                    \"subnet-id\": 66,",
-        "                    \"ip-address\": \"2001:db8:abcd::333\",",
-        "                    \"type\": \"IA_NA\",",
-        "                    ...",
-        "                }",
-        "            ]",
-        "        }",
+        "    \"command\": \"lease6-bulk-apply\",",
+        "    \"arguments\": {",
+        "        \"deleted-leases\": [",
+        "            {",
+        "                \"ip-address\": \"2001:db8:abcd::\",",
+        "                \"type\": \"IA_PD\",",
+        "                ...",
+        "            },",
+        "            {",
+        "                \"ip-address\": \"2001:db8:abcd::234\",",
+        "                \"type\": \"IA_NA\",",
+        "                ...",
+        "            }",
+        "        ],",
+        "        \"leases\": [",
+        "            {",
+        "                \"subnet-id\": 66,",
+        "                \"ip-address\": \"2001:db8:cafe::\",",
+        "                \"type\": \"IA_PD\",",
+        "                ...",
+        "            },",
+        "            {",
+        "                \"subnet-id\": 66,",
+        "                \"ip-address\": \"2001:db8:abcd::333\",",
+        "                \"type\": \"IA_NA\",",
+        "                ...",
+        "            }",
+        "        ]",
+        "    }",
         "}"
     ],
     "hook": "lease_cmds",
@@ -73,4 +73,4 @@
     "support": [
         "kea-dhcp6"
     ]
-}
\ No newline at end of file
+}
index 1e11982f5976164cdf63f360970f773b46fec38a..022fc1f02ea8c68069e16b144c45b90fb7b637f9 100644 (file)
@@ -5,7 +5,7 @@
     ],
     "cmd-comment": [
         "The network6-del command uses exactly the same syntax for",
-        "                    both the command and the response."
+        "both the command and the response."
     ],
     "cmd-syntax": [
         "{",
@@ -30,4 +30,4 @@
     "support": [
         "kea-dhcp6"
     ]
-}
\ No newline at end of file
+}
index 25e0ea43eb0a9632acbf5c382e1eb6cb4de6118b..fb3c11e79194631f95bd791366156d95b9ad7d32 100644 (file)
@@ -1,10 +1,10 @@
 {
     "avail": "1.2.0",
     "brief": [
-        "adds a new host reservation. The reservation may include IPv4 address,",
-        "        IPv6 addresses, IPv6 prefixes, various identifiers, a class",
-        "        the client will be assigned to, DHCPv4 and DHCPv6 options and",
-        "        more."
+        "Adds a new host reservation. The reservation may include IPv4 address,",
+        "IPv6 addresses, IPv6 prefixes, various identifiers, a class",
+        "the client will be assigned to, DHCPv4 and DHCPv6 options and",
+        "more."
     ],
     "cmd-comment": [
         "Note the ip-address, client-id, next-server, server-hostname and",
@@ -51,4 +51,4 @@
         "kea-dhcp4",
         "kea-dhcp6"
     ]
-}
\ No newline at end of file
+}
index 6f4b8e1ad3dfebb352591c4f179f37331a75656a..5ebab230160d60acf118d36cf6033ec4ab97eeaf 100644 (file)
@@ -5,7 +5,7 @@
     ],
     "cmd-comment": [
         "The server will respond with a confirmation that the shutdown",
-        "                    procedure has been initiated."
+        "procedure has been initiated."
     ],
     "cmd-syntax": [
         "{",
@@ -20,4 +20,4 @@
         "kea-dhcp-ddns",
         "kea-ctrl-agent"
     ]
-}
\ No newline at end of file
+}
index f5f2a8f92657e4750f69ef779561526e93986c84..d0dc6212752cbfbaa119cd848ced60edcb52d0e3 100644 (file)
@@ -2,7 +2,7 @@
     "avail": "1.4.0",
     "brief": [
         "The stat-lease4-get command fetches lease statistics for a range",
-        "              of known IPv4 subnets."
+        "of known IPv4 subnets."
     ],
     "cmd-syntax": [
         "{",
@@ -34,4 +34,4 @@
     "support": [
         "kea-dhcp4"
     ]
-}
\ No newline at end of file
+}
index 4334dedcce02f4a0f96eb6519124f84823d56d49..000f5fd0750695cbef68b62509570ab73143f997 100644 (file)
@@ -2,7 +2,7 @@
     "avail": "1.4.0",
     "brief": [
         "The stat-lease6-get command fetches lease statistics for a range",
-        "              of known IPv6 subnets."
+        "of known IPv6 subnets."
     ],
     "cmd-syntax": [
         "{",
@@ -35,4 +35,4 @@
     "support": [
         "kea-dhcp6"
     ]
-}
\ No newline at end of file
+}
index 5367573a46b2f9d8ef87c4b6328f3f9da1fc4b37..22027e5099eca6955f68f1f3982dc6d2a14e11c2 100644 (file)
@@ -2,8 +2,8 @@
     "avail": "1.2.0",
     "brief": [
         "The version-get command returns extended information about",
-        "              Kea version. The returned string is the same as if Kea would",
-        "              be run with -V command line option."
+        "Kea version. The returned string is the same as if Kea would",
+        "be run with ``-V`` command line option."
     ],
     "cmd-syntax": [
         "{",
@@ -18,4 +18,4 @@
         "kea-dhcp-ddns",
         "kea-ctrl-agent"
     ]
-}
\ No newline at end of file
+}