X-Git-Url: http://average.org/gitweb/?a=blobdiff_plain;f=SPEC.md;h=1c1292ce803bf65d6558f3bd641045cdbd72768c;hb=2937774909c747862ae9fe6efe7613bffe3efad3;hp=5c659b75853cbed01c1c5f7611b8e1152c165383;hpb=108b6c21a35c2a26dae594bc06d02d98696752d8;p=pdns-pipe-nmc.git

diff --git a/SPEC.md b/SPEC.md
index 5c659b7..1c1292c 100644
--- a/SPEC.md
+++ b/SPEC.md
@@ -17,8 +17,9 @@ This specification is implemented by the `pdns-pipe-nmc` program.
 
 ### `DomObj` Object
 
-`DomObj` either a `String` containing a dotted quad (see Note below),
-or a JSON `Map`, with the following attributes, all optional:
+`DomObj` is a data structure that is associated with an FQDN. It is
+either a `String` containing a dotted quad (see Note below), or a
+JSON `Map`, with the following attributes, all optional:
 
 | Key         | Type                                  | Comment                                    |
 |-------------|---------------------------------------|--------------------------------------------|
@@ -188,7 +189,7 @@ Does not translate into any DNS RR. Contains Tor hidden service address.
 
 #### i2p attribute
 
-Does not translate into any DNS RR. Contains an object with three
+Does not translate into any DNS RR. It is a JSON Map with three
 optional String attributes: `"destination"`, `"name"` and `"b32"`.
 
 ```
@@ -306,6 +307,9 @@ the current domain object.
 
 #### map attribute
 
+FIXME - explain handling of the keys with dots.
+Also, add checks to the code to disallow empty elements.
+
 JSON Map object containing subdomain names as its keys and domain
 objects as values. Element of the map with empty key "" has special
 meaning: the value of this map element is merged into the current