--- a/README	Tue Feb 24 18:06:32 2015 +0200
+++ b/README	Tue Feb 24 18:22:07 2015 +0200
@@ -25,3 +25,26 @@
     1.0.0                             PTR   foo.test.
     2.0.0                             PTR   bar.test.
 
+=== Generated hosts ===
+The hosts file format supports something similar to bind9's $GENERATE directive for hosts:
+
+    [asdf{1-3}]
+        ip  = 10.100.100.$
+
+    $ bin/pvl.hosts-dns --forward-zone=asdf etc/hosts/asdf 
+    asdf1@asdf                        A     10.100.100.1
+    asdf2@asdf                        A     10.100.100.2
+    asdf3@asdf                        A     10.100.100.3
+
+Note that the generate directives are interpreted and compiled directly by pvl.hosts. 
+
+Most of the $GENERATE options should be supported, with a little clever hackery:
+
+    [asdf{1-5/2}{0,2}]
+       ip  = 10.100.100.$${10}
+
+    $ bin/pvl.hosts-dns --forward-zone=asdf2 etc/hosts/asdf2
+    asdf01@asdf2                      A     10.100.100.11
+    asdf03@asdf2                      A     10.100.100.13
+    asdf05@asdf2                      A     10.100.100.15
+