diff --git a/example/example-map-gen-settings.json b/example/example-map-gen-settings.json
index 6a7a944..eab1907 100644
--- a/example/example-map-gen-settings.json
+++ b/example/example-map-gen-settings.json
@@ -1,34 +1,74 @@
 {
-    "_comment": "Sizes can be specified as none, very-low, low, normal, high, very-high",
-
-    "terrain_segmentation" : 1,
-    "water" : 1,
-    "starting_area" : "none",
-    "peaceful_mode" : false,
-    "research_queue_from_the_start" : "always",
-
-    "autoplace_controls" : {
-        "coal"        : {"frequency" : 0.20, "richness" : 0.50, "size" : 1.50},
-        "copper-ore"  : {"frequency" : 0.20, "richness" : 0.50, "size" : 1.50},
-        "crude-oil"   : {"frequency" : 0.20, "richness" : 0.50, "size" : 1.50},
-        "enemy-base"  : {"frequency" : 0.20, "richness" : 0.50, "size" : 0.50},
-        "iron-ore"    : {"frequency" : 0.20, "richness" : 0.50, "size" : 1.50},
-        "stone"       : {"frequency" : 0.20, "richness" : 0.50, "size" : 1.50},
-        "trees"       : {"frequency" : 0.50, "richness" : 1.00, "size" : 1.50},
-        "uranium-ore" : {"frequency" : 0.20, "richness" : 0.50, "size" : 1.50}
-    },
-
-    "cliff_settings" : {
-        "cliff_elevation_0" : 10,
-        "cliff_elevation_interval" : 10,
-        "name" : "cliff",
-        "richness" : 1
-    },
-
-    "property_expression_names" : {
-        "control-setting:aux:bias" : "0.00",
-        "control-setting:aux:frequency:multiplier" : "1.00",
-        "control-setting:moisture:bias" : "0.00",
-        "control-setting:moisture:frequency:multiplier" : "1.00"
-    }
-}
+  "_terrain_segmentation_comment": "Inverse of map scale",
+  "terrain_segmentation": 1,
+  
+  "_water_comment":
+  [
+    "Multiplier for water 'coverage' - higher increases the water level.",
+    "Water level = 10 * log2(this value)"
+  ],
+  "water": 1,
+  
+  "_comment_width+height": "Width and height of map, in tiles; 0 means infinite",
+  "width": 0,
+  "height": 0,
+  
+  "_starting_area_comment": "Multiplier for 'biter free zone radius'",
+  "starting_area": 1,
+  
+  "peaceful_mode": false,
+  
+  "autoplace_controls":
+  {
+    "coal"        : {"frequency" : 0.20, "richness" : 0.50, "size" : 1.50},
+    "copper-ore"  : {"frequency" : 0.20, "richness" : 0.50, "size" : 1.50},
+    "crude-oil"   : {"frequency" : 0.20, "richness" : 0.50, "size" : 1.50},
+    "enemy-base"  : {"frequency" : 0.20, "richness" : 0.50, "size" : 0.50},
+    "iron-ore"    : {"frequency" : 0.20, "richness" : 0.50, "size" : 1.50},
+    "stone"       : {"frequency" : 0.20, "richness" : 0.50, "size" : 1.50},
+    "trees"       : {"frequency" : 0.50, "richness" : 1.00, "size" : 1.50},
+    "uranium-ore" : {"frequency" : 0.20, "richness" : 0.50, "size" : 1.50}
+  },
+  
+  "cliff_settings":
+  {
+    "_name_comment": "Name of the cliff prototype",
+    "name": "cliff",
+    
+    "_cliff_elevation_0_comment": "Elevation of first row of cliffs",
+    "cliff_elevation_0": 10,
+    
+    "_cliff_elevation_interval_comment": "Elevation difference between successive rows of cliffs",
+    "cliff_elevation_interval": 10,
+    
+    "_richness_comment": "Multiplier for cliff continuity; 0 will result in no cliffs, 10 will make all cliff rows completely solid",
+    "richness": 1
+  },
+  
+  "_property_expression_names_comment":
+  [
+    "Overrides for property value generators",
+    "Elevation influences water and cliff placement.",
+    "Leave it blank to get 'normal' terrain.",
+    "Use '0_16-elevation' to reproduce terrain from 0.16.",
+    "Use '0_17-island' to get an island.",
+    "elevation'': ''0_17-island"
+  ],
+  "property_expression_names":
+  {
+    
+    
+    "control-setting:aux:bias": "0.00",
+    "control-setting:aux:frequency:multiplier": "1.00",
+    "control-setting:moisture:bias": "0.00",
+    "control-setting:moisture:frequency:multiplier": "1.00"
+  },
+  
+  "starting_points":
+  [
+    {"x": 0, "y": 0}
+  ],
+  
+  "_seed_comment": "Use null for a random seed, number for a specific seed.",
+  "seed": null
+}
\ No newline at end of file