more README work
[zonemaker.git] / README.rst
index 733f3ba824328ce7e023ada3d696980b74db5a12..128bee6e4d70df968c3bacdbed954faf6e02a1a3 100644 (file)
@@ -6,18 +6,24 @@ Introduction
 
 This is zonemaker_, a tool to generate DNS zone files from Python.
 
-The plain zone file format is pretty limited. There are not even variables, so in many cases IP addresses and other data has to be repeated several times.
-zonemaker is an attempt to provide more flexibility, by allowing you to write your zones in Python.
-Hence all the usuel fatures, like variables, macros (aka functions) and loops, are available to generate DNS zone data.
-At the same time, zonemaker is reasonably simple and close to the actual structure of a DNS zonefile, so it is suited for small setups.
-The output of zonemaker is a standard zonefile, so it can be used with any DNS server supporting those.
+The plain zone file format is pretty limited. There are not even variables, so 
+in many cases IP addresses and other data has to be repeated several times. 
+zonemaker is an attempt to provide more flexibility, by allowing you to write 
+your zones in Python. Hence all the usuel fatures, like variables, macros (aka 
+functions) and loops, are available to generate DNS zone data. At the same time, 
+zonemaker is reasonably simple and close to the actual structure of a DNS 
+zonefile, so it is suited for small setups. The output of zonemaker is a 
+standard zonefile, so it can be used with any DNS server supporting those.
 
 .. _dyn-nsupdate: https://www.ralfj.de/projects/zonemaker
 
 Usage
 -----
 
-TODO
+Simply call ``zonemaker`` with the zone python file as argument. The result will 
+be printed to stdout. See ``db.example.com.py`` for a sample file demonstrating 
+the use of the interface. ``Makefile.sample`` shows how a makefile which first 
+updates the zone, and then tells BIND to reload, could look like.
 
 Source, License
 ---------------