From 166c822d91432cb0b06afaad9440678d3bf9e39d Mon Sep 17 00:00:00 2001
From: Miek Gieben <miek@miek.nl>
Date: Sun, 22 Jan 2017 08:14:48 +0000
Subject: [PATCH] docs: update the zone specification (#490)

Add more words about how to specify the zone:port in a Corefile.

Fixes #489
---
 README.md | 28 ++++++++++++++++++++++++----
 1 file changed, 24 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index 424efd21d..079eb28d2 100644
--- a/README.md
+++ b/README.md
@@ -141,13 +141,33 @@ nameserver *and* rewrite ANY queries to HINFO.
 }
 ~~~
 
+### Zone Specification
 
-## What Remains To Be Done
+The following Corefile fragment is legal, but does not explicitly define a zone to listen on:
 
-* Optimizations.
-* Load testing.
-* The [issues](https://github.com/miekg/coredns/issues).
+~~~ txt
+{
+   # ...
+}
+~~~
 
+This defaults to `.:53` (or whatever `-dns.port` is).
+
+The next one only defines a port:
+~~~ txt
+:123 {
+    # ...
+}
+~~~
+This defaults to the root zone `.`, but can't be overruled with the `-dns.port` flag.
+
+Just specifying a zone, default to listening on port 53 (can still be overridden with `-dns.port`:
+
+~~~ txt
+example.org {
+    # ...
+}
+~~~
 
 ## Blog and Contact