auto make -f Makefile.doc

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

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
+

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).