From: Tomek Mrugalski <tomasz@isc.org>
Date: Wed, 10 Oct 2018 10:48:00 +0000 (+0200)
Subject: [#10,!3] Syntax is now copied over correctly from json files to xml
X-Git-Tag: 176-update-to-sysrepo-0-7-6-release_base~73
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=20c44eaddaa329a58dabe4f26274660259c86b2d;p=thirdparty%2Fkea.git

[#10,!3] Syntax is now copied over correctly from json files to xml

 - it is now possible to use formatting in comments.
---

diff --git a/doc/api/config-set.json b/doc/api/config-set.json
index dd39e94132..b8b7b00927 100644
--- a/doc/api/config-set.json
+++ b/doc/api/config-set.json
@@ -13,7 +13,7 @@
         }
      }
 }",
-    "cmd-comment": "where <server> is the configuration element name for a given server such as \"Dhcp4\" or \"Dhcp6\"",
+    "cmd-comment": "where &lt;server&gt; is the configuration element name for a given server such as \"Dhcp4\" or \"Dhcp6\"",
     "resp-syntax": "    {\"result\": 0, \"text\": \"Configuration successful.\" }
 
     or
diff --git a/doc/api/config-test.json b/doc/api/config-test.json
index 9f5daac5be..aa6ef357db 100644
--- a/doc/api/config-test.json
+++ b/doc/api/config-test.json
@@ -13,7 +13,7 @@
         }
      }
 }",
-    "cmd-comment": "where <server> is the configuration element name for a given server such as \"Dhcp4\" or \"Dhcp6\"",
+    "cmd-comment": "where &gt;server&lt; is the configuration element name for a given server such as \"Dhcp4\" or \"Dhcp6\"",
     "resp-syntax": "{\"result\": 0, \"text\": \"Configuration seems sane...\" }
 
     or
diff --git a/doc/docgen/kea_docgen.cc b/doc/docgen/kea_docgen.cc
index a0d665e2e1..3a9044e834 100644
--- a/doc/docgen/kea_docgen.cc
+++ b/doc/docgen/kea_docgen.cc
@@ -428,7 +428,7 @@ public:
               << "}</screen>" << endl;
         }
         if (cmd->contains("cmd-comment")) {
-            f << escapeString(cmd->get("cmd-comment")->stringValue());
+            f << cmd->get("cmd-comment")->stringValue();
         }
         f << "</para>" << endl << endl;
 
diff --git a/doc/guide/api.xml b/doc/guide/api.xml
index 98e4fd6dd0..0383d34761 100644
--- a/doc/guide/api.xml
+++ b/doc/guide/api.xml
@@ -573,7 +573,7 @@ Result is an integer representation of the status. Currently supported statuses
   <screen>{
     "command": "config-get"
 }</screen>
-&lt;command&gt;config-get&lt;/command&gt; takes no parameters.</para>
+<command>config-get</command> takes no parameters.</para>
 
 <para>Response syntax:
   <screen>{
@@ -691,7 +691,7 @@ Result is an integer representation of the status. Currently supported statuses
         }
      }
 }</screen>
-where &lt;server&gt; is the configuration element name for a given server such as "Dhcp4" or "Dhcp6"</para>
+where &gt;server&lt; is the configuration element name for a given server such as "Dhcp4" or "Dhcp6"</para>
 
 <para>Response syntax:
   <screen>{"result": 0, "text": "Configuration seems sane..." }
@@ -3011,9 +3011,9 @@ If no IPv6 subnets are found, an error code is returned along with the error des
 <!-- start of version-get -->
 <section xml:id="reference-version-get">
 <title>version-get reference</title>
-<para xml:id="ref-version-get"><command>version-get</command> - The version-get command returns on the control channel what the
-              command line -v argument displays with in arguments the extended
-              version, i.e., what the command line -V argument displays.</para>
+<para xml:id="ref-version-get"><command>version-get</command> - 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.</para>
 
 <para>Supported by: <command><link linkend="commands-kea-dhcp4">kea-dhcp4</link></command>, <command><link linkend="commands-kea-dhcp6">kea-dhcp6</link></command>, <command><link linkend="commands-kea-ctrl-agent">kea-ctrl-agent</link></command></para>