1 files changed, 113 insertions, 0 deletions
diff --git a/doc/examples/kea4/comments.json b/doc/examples/kea4/comments.json
new file mode 100644
index 0000000..a5cfbdc
--- /dev/null
+++ b/doc/examples/kea4/comments.json
@@ -0,0 +1,113 @@
+// This is an example configuration file for the DHCPv4 server in Kea.
+// It uses embedded (i.e., which will be included in configuration objects
+// and not stripped by at lexical analysis) comments.
+
+{ "Dhcp4":
+
+{
+   // Global scope
+   "comment": "A DHCPv4 server",
+
+   // In interface config
+   "interfaces-config": {
+       "comment": "Use wildcard",
+       "interfaces": [ "*" ] },
+
+   // In option definitions
+   "option-def": [ {
+       "comment": "An option definition",
+       "name": "foo",
+       "code": 100,
+       "type": "ipv4-address",
+       "space": "isc"
+    } ],
+
+   // In option data
+   "option-data": [ {
+       "comment": "Set option value",
+       "name": "dhcp-message",
+       "data": "ABCDEF0105",
+       "csv-format": false
+    } ],
+
+   // In client classes
+   "client-classes": [
+       {
+          "comment": "match all",
+          "name": "all",
+          "test": "'' == ''"
+       },
+       // Of course comments are optional
+       {
+          "name": "none"
+       },
+       // A comment and a user-context can be specified
+       {
+          "comment": "a comment",
+          "name": "both",
+          "user-context": {
+              "version": 1
+          }
+       }
+   ],
+
+   // In control socket (more for the agent)
+   "control-socket": {
+       "socket-type": "unix",
+       "socket-name": "/tmp/kea4-ctrl-socket",
+       "user-context": { "comment": "Indirect comment" }
+   },
+
+   // In shared networks
+   "shared-networks": [ {
+       "comment": "A shared network",
+       "name": "foo",
+
+       // In subnets
+       "subnet4": [
+         {
+           "comment": "A subnet",
+           "subnet": "192.0.1.0/24",
+           "id": 100,
+
+           // In pools
+           "pools": [
+             {
+                "comment": "A pool",
+                "pool": "192.0.1.1-192.0.1.10"
+             }
+           ],
+
+           // In host reservations
+           "reservations": [
+             {
+                "comment": "A host reservation",
+                "hw-address": "AA:BB:CC:DD:EE:FF",
+                "hostname": "foo.example.com",
+
+                // Again in an option data
+                "option-data": [ {
+                    "comment": "An option in a reservation",
+                    "name": "domain-name",
+                    "data": "example.com"
+                } ]
+             }
+           ]
+         }
+       ]
+    } ],
+
+   // In dhcp ddns
+   "dhcp-ddns": {
+       "comment": "No dynamic DNS",
+       "enable-updates": false
+   },
+
+   // In loggers
+   "loggers": [ {
+       "comment": "A logger",
+       "name": "kea-dhcp4"
+   } ]
+}
+
+}