[#1102] Updated doc

diff --git a/ChangeLog b/ChangeLog
index a3ae341cdeaf40bc6f1efddc18cab7d22989f6e1..b2d41437ad307ef0daef9350f1fd32e81dd01fc6 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,12 @@
+1802.  [bug]           fdupont
+       Removed the bug which allowed for repeating the same configuration
+       parameter multiple times in the same scope. The second occurrence
+       of the parameter overwrote the first occurrence causing server
+       misconfiguration. Starting from this change an error is raised
+       when the same parameter occurs multiple times in a given scope.
+       the location of the first value.
+       (Gitlab #1102)
+
 1801.  [doc]           fdupont
        Moved JSON files describing commands to the share directory
        and adding a new access entry taking read or write values.

diff --git a/doc/sphinx/arm/config.rst b/doc/sphinx/arm/config.rst
index cffa05c44da33e8912991e4bcc2bcef881421b2b..d604cec62e582b0090aee4ebf51c3faf5255ec7c 100644 (file)
--- a/doc/sphinx/arm/config.rst
+++ b/doc/sphinx/arm/config.rst
@@ -34,6 +34,16 @@ defined in `RFC 7159 <https://tools.ietf.org/html/rfc7159>`__ and `ECMA
 In particular, the only boolean values allowed are true or false (all
 lowercase). The capitalized versions (True or False) are not accepted.
 
+Even if the JSON standard (ECMA 404) does not require JSON objects
+(i.e. name/value maps) to have unique entries Kea implements them
+using a std::map so:
+
+-  if there are multiple values for the same name in an object/map
+   the last value overwrites previous values
+
+-  configuration file parsers since Kea 1.9.0 version raise a syntax error
+   in such cases
+
 Kea components use an extended JSON with additional features allowed:
 
 -  shell comments: any text after the hash (#) character is ignored.