auto make -f Makefile.doc

3 files changed, 27 insertions, 2 deletions

diff --git a/man/coredns-azure.7 b/man/coredns-azure.7
index 903aaa345..41958b530 100644
--- a/man/coredns-azure.7
+++ b/man/coredns-azure.7
@@ -9,7 +9,7 @@
 .PP
 The azure plugin is useful for serving zones from Microsoft Azure DNS. The \fIazure\fP plugin supports
 all the DNS records supported by Azure, viz. A, AAAA, CNAME, MX, NS, PTR, SOA, SRV, and TXT
-record types.
+record types. NS record type is not supported by azure private DNS.
 
 .SH "SYNTAX"
 .PP
diff --git a/man/coredns-bind.7 b/man/coredns-bind.7
index 7bfaa5cec..ff476eaa5 100644
--- a/man/coredns-bind.7
+++ b/man/coredns-bind.7
@@ -75,3 +75,28 @@ The following sample is equivalent to the preceding:
 .fi
 .RE
 
+.SH "BUGS"
+.PP
+When defining more than one server block, take care not to bind more than one server to the same
+address and port. Doing so will result in unpredictable behavior (requests may be randomly
+served by either server). Keep in mind that \fIwithout\fP the \fIbind\fP plugin, a server will bind to all
+interfaces, and this will collide with another server if it's using \fIbind\fP to listen to an interface
+on the same port. For example, the following creates two servers that both listen on 127.0.0.1:53,
+which would result in unpredictable behavior for queries in \fB\fCa.bad.example.com\fR:
+
+.PP
+.RS
+
+.nf
+a.bad.example.com {
+    bind 127.0.0.1
+    forward . 1.2.3.4
+}
+
+bad.example.com {
+    forward . 5.6.7.8
+}
+
+.fi
+.RE
+
diff --git a/man/coredns.1 b/man/coredns.1
index 68fef4343..eb3272405 100644
--- a/man/coredns.1
+++ b/man/coredns.1
@@ -58,5 +58,5 @@ Apache License 2.0
 
 .SH "SEE ALSO"
 .PP
-Corefile(5) coredns-k8s_external(7) coredns-nsid(7) coredns-any(7) coredns-debug(7) coredns-acl(7) coredns-dnssec(7) coredns-health(7) coredns-grpc(7) coredns-sign(7) coredns-log(7) coredns-tls(7) coredns-file(7) coredns-root(7) coredns-autopath(7) coredns-auto(7) coredns-erratic(7) coredns-chaos(7) coredns-dnstap(7) coredns-pprof(7) coredns-bufsize(7) coredns-clouddns(7) coredns-loadbalance(7) coredns-ready(7) coredns-whoami(7) coredns-bind(7) coredns-loop(7) coredns-import(7) coredns-hosts(7) coredns-template(7) coredns-azure(7) coredns-cache(7) coredns-forward(7) coredns-secondary(7) coredns-route53(7) coredns-transfer(7) coredns-metadata(7) coredns-local(7) coredns-errors(7) coredns-kubernetes(7) coredns-metrics(7) coredns-reload(7) coredns-rewrite(7) coredns-dns64(7) coredns-etcd(7) coredns-cancel(7) coredns-trace(7).
+Corefile(5) coredns-k8s_external(7) coredns-any(7) coredns-debug(7) coredns-acl(7) coredns-dnssec(7) coredns-health(7) coredns-grpc(7) coredns-sign(7) coredns-log(7) coredns-kubernetes(7) coredns-file(7) coredns-nsid(7) coredns-autopath(7) coredns-loop(7) coredns-erratic(7) coredns-clouddns(7) coredns-chaos(7) coredns-dnstap(7) coredns-pprof(7) coredns-bufsize(7) coredns-tls(7) coredns-loadbalance(7) coredns-root(7) coredns-whoami(7) coredns-bind(7) coredns-auto(7) coredns-import(7) coredns-template(7) coredns-azure(7) coredns-errors(7) coredns-cache(7) coredns-forward(7) coredns-hosts(7) coredns-secondary(7) coredns-route53(7) coredns-local(7) coredns-metadata(7) coredns-transfer(7) coredns-ready(7) coredns-reload(7) coredns-rewrite(7) coredns-metrics(7) coredns-dns64(7) coredns-etcd(7) coredns-cancel(7) coredns-trace(7).