update corefile(5) and regen (#1904)

Add that we support https and do a regen.

Signed-off-by: Miek Gieben <miek@miek.nl>

28 files changed, 47 insertions, 33 deletions

diff --git a/man/coredns-auto.7 b/man/coredns-auto.7
index d84dd4e07..0a9f43c80 100644
--- a/man/coredns-auto.7
+++ b/man/coredns-auto.7
@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "COREDNS\-AUTO" "7" "May 2018" "CoreDNS" "CoreDNS plugins"
+.TH "COREDNS\-AUTO" "7" "June 2018" "CoreDNS" "CoreDNS plugins"
 .
 .SH "NAME"
 \fIauto\fR \- enables serving zone data from an RFC 1035\-style master file, which is automatically picked up from disk\.
diff --git a/man/coredns-autopath.7 b/man/coredns-autopath.7
index 7fc381296..972341890 100644
--- a/man/coredns-autopath.7
+++ b/man/coredns-autopath.7
@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "COREDNS\-AUTOPATH" "7" "May 2018" "CoreDNS" "CoreDNS plugins"
+.TH "COREDNS\-AUTOPATH" "7" "June 2018" "CoreDNS" "CoreDNS plugins"
 .
 .SH "NAME"
 \fIautopath\fR \- allows for server\-side search path completion\.
diff --git a/man/coredns-bind.7 b/man/coredns-bind.7
index 354f1b914..ffbc953f7 100644
--- a/man/coredns-bind.7
+++ b/man/coredns-bind.7
@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "COREDNS\-BIND" "7" "May 2018" "CoreDNS" "CoreDNS plugins"
+.TH "COREDNS\-BIND" "7" "June 2018" "CoreDNS" "CoreDNS plugins"
 .
 .SH "NAME"
 \fIbind\fR \- overrides the host to which the server should bind\.
diff --git a/man/coredns-cache.7 b/man/coredns-cache.7
index c963d4133..f97bf5d92 100644
--- a/man/coredns-cache.7
+++ b/man/coredns-cache.7
@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "COREDNS\-CACHE" "7" "May 2018" "CoreDNS" "CoreDNS plugins"
+.TH "COREDNS\-CACHE" "7" "June 2018" "CoreDNS" "CoreDNS plugins"
 .
 .SH "NAME"
 \fIcache\fR \- enables a frontend cache\.
diff --git a/man/coredns-chaos.7 b/man/coredns-chaos.7
index fe294411e..039c4e31d 100644
--- a/man/coredns-chaos.7
+++ b/man/coredns-chaos.7
@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "COREDNS\-CHAOS" "7" "May 2018" "CoreDNS" "CoreDNS plugins"
+.TH "COREDNS\-CHAOS" "7" "June 2018" "CoreDNS" "CoreDNS plugins"
 .
 .SH "NAME"
 \fIchaos\fR \- allows for responding to TXT queries in the CH class\.
diff --git a/man/coredns-debug.7 b/man/coredns-debug.7
index 0c4345a9d..4ec4fe710 100644
--- a/man/coredns-debug.7
+++ b/man/coredns-debug.7
@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "COREDNS\-DEBUG" "7" "May 2018" "CoreDNS" "CoreDNS plugins"
+.TH "COREDNS\-DEBUG" "7" "June 2018" "CoreDNS" "CoreDNS plugins"
 .
 .SH "NAME"
 \fIdebug\fR \- disables the automatic recovery upon a crash so that you\'ll get a nice stack trace\.
diff --git a/man/coredns-dnssec.7 b/man/coredns-dnssec.7
index cbb6e744a..7cdddd6d4 100644
--- a/man/coredns-dnssec.7
+++ b/man/coredns-dnssec.7
@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "COREDNS\-DNSSEC" "7" "May 2018" "CoreDNS" "CoreDNS plugins"
+.TH "COREDNS\-DNSSEC" "7" "June 2018" "CoreDNS" "CoreDNS plugins"
 .
 .SH "NAME"
 \fIdnssec\fR \- enable on\-the\-fly DNSSEC signing of served data\.
diff --git a/man/coredns-dnstap.7 b/man/coredns-dnstap.7
index 9b627e6d1..764ba839b 100644
--- a/man/coredns-dnstap.7
+++ b/man/coredns-dnstap.7
@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "COREDNS\-DNSTAP" "7" "May 2018" "CoreDNS" "CoreDNS plugins"
+.TH "COREDNS\-DNSTAP" "7" "June 2018" "CoreDNS" "CoreDNS plugins"
 .
 .SH "NAME"
 \fIdnstap\fR \- enable logging to dnstap
diff --git a/man/coredns-erratic.7 b/man/coredns-erratic.7
index d8c36c513..7e4b07e29 100644
--- a/man/coredns-erratic.7
+++ b/man/coredns-erratic.7
@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "COREDNS\-ERRATIC" "7" "May 2018" "CoreDNS" "CoreDNS plugins"
+.TH "COREDNS\-ERRATIC" "7" "June 2018" "CoreDNS" "CoreDNS plugins"
 .
 .SH "NAME"
 \fIerratic\fR \- a plugin useful for testing client behavior\.
diff --git a/man/coredns-errors.7 b/man/coredns-errors.7
index cc67c74f5..d83b03566 100644
--- a/man/coredns-errors.7
+++ b/man/coredns-errors.7
@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "COREDNS\-ERRORS" "7" "May 2018" "CoreDNS" "CoreDNS plugins"
+.TH "COREDNS\-ERRORS" "7" "June 2018" "CoreDNS" "CoreDNS plugins"
 .
 .SH "NAME"
 \fIerrors\fR \- enable error logging\.
diff --git a/man/coredns-etcd.7 b/man/coredns-etcd.7
index ee65d92af..4f2b5fa6d 100644
--- a/man/coredns-etcd.7
+++ b/man/coredns-etcd.7
@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "COREDNS\-ETCD" "7" "May 2018" "CoreDNS" "CoreDNS plugins"
+.TH "COREDNS\-ETCD" "7" "June 2018" "CoreDNS" "CoreDNS plugins"
 .
 .SH "NAME"
 \fIetcd\fR \- enables reading zone data from an etcd instance\.
diff --git a/man/coredns-federation.7 b/man/coredns-federation.7
index 8d23cae90..b579f03aa 100644
--- a/man/coredns-federation.7
+++ b/man/coredns-federation.7
@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "COREDNS\-FEDERATION" "7" "May 2018" "CoreDNS" "CoreDNS plugins"
+.TH "COREDNS\-FEDERATION" "7" "June 2018" "CoreDNS" "CoreDNS plugins"
 .
 .SH "NAME"
 \fIfederation\fR \- enables federated queries to be resolved via the kubernetes plugin\.
diff --git a/man/coredns-file.7 b/man/coredns-file.7
index 47418f1bd..a103e4b91 100644
--- a/man/coredns-file.7
+++ b/man/coredns-file.7
@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "COREDNS\-FILE" "7" "May 2018" "CoreDNS" "CoreDNS plugins"
+.TH "COREDNS\-FILE" "7" "June 2018" "CoreDNS" "CoreDNS plugins"
 .
 .SH "NAME"
 \fIfile\fR \- enables serving zone data from an RFC 1035\-style master file\.
diff --git a/man/coredns-forward.7 b/man/coredns-forward.7
index dd95866b9..dac634fd3 100644
--- a/man/coredns-forward.7
+++ b/man/coredns-forward.7
@@ -115,7 +115,15 @@ forward FROM TO\.\.\. {
 Also note the TLS config is "global" for the whole forwarding proxy if you need a different \fBtls\-name\fR for different upstreams you\'re out of luck\.
 .
 .P
-On each endpoint, the timeouts of the communication are set by default and automatically tuned depending early results\. \- dialTimeout by default is 30 sec, and can decrease automatically down to 100ms \- readTimeout by default is 2 sec, and can decrease automatically down to 10ms
+On each endpoint, the timeouts of the communication are set by default and automatically tuned depending early results\.
+.
+.IP "\(bu" 4
+dialTimeout by default is 30 sec, and can decrease automatically down to 100ms
+.
+.IP "\(bu" 4
+readTimeout by default is 2 sec, and can decrease automatically down to 200ms
+.
+.IP "" 0
 .
 .SH "METRICS"
 If monitoring is enabled (via the \fIprometheus\fR directive) then the following metric are exported:
diff --git a/man/coredns-health.7 b/man/coredns-health.7
index 23ec1d933..bca1bf999 100644
--- a/man/coredns-health.7
+++ b/man/coredns-health.7
@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "COREDNS\-HEALTH" "7" "May 2018" "CoreDNS" "CoreDNS plugins"
+.TH "COREDNS\-HEALTH" "7" "June 2018" "CoreDNS" "CoreDNS plugins"
 .
 .SH "NAME"
 \fIhealth\fR \- enables a health check endpoint\.
diff --git a/man/coredns-kubernetes.7 b/man/coredns-kubernetes.7
index 4fe003222..39177e958 100644
--- a/man/coredns-kubernetes.7
+++ b/man/coredns-kubernetes.7
@@ -107,6 +107,9 @@ kubernetes [ZONES\.\.\.] {
 .SH "HEALTH"
 This plugin implements dynamic health checking\. Currently this is limited to reporting healthy when the API has synced\.
 .
+.SH "WATCH"
+This plugin implements watch\. A client that connects to CoreDNS using \fBcoredns/client\fR can be notified of changes to A, AAAA, and SRV records for Kubernetes services and endpoints\.
+.
 .SH "EXAMPLES"
 Handle all queries in the \fBcluster\.local\fR zone\. Connect to Kubernetes in\-cluster\. Also handle all \fBin\-addr\.arpa\fR \fBPTR\fR requests for \fB10\.0\.0\.0/17\fR \. Verify the existence of pods when answering pod requests\. Resolve upstream records against \fB10\.102\.3\.10\fR\. Note we show the entire server block here:
 .
diff --git a/man/coredns-loadbalance.7 b/man/coredns-loadbalance.7
index 07ec73c10..7be9dae82 100644
--- a/man/coredns-loadbalance.7
+++ b/man/coredns-loadbalance.7
@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "COREDNS\-LOADBALANCE" "7" "May 2018" "CoreDNS" "CoreDNS plugins"
+.TH "COREDNS\-LOADBALANCE" "7" "June 2018" "CoreDNS" "CoreDNS plugins"
 .
 .SH "NAME"
 \fIloadbalance\fR \- acts as a round\-robin DNS loadbalancer by randomizing the order of A and AAAA records in the answer\.
diff --git a/man/coredns-log.7 b/man/coredns-log.7
index 234668e35..76a44c273 100644
--- a/man/coredns-log.7
+++ b/man/coredns-log.7
@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "COREDNS\-LOG" "7" "May 2018" "CoreDNS" "CoreDNS plugins"
+.TH "COREDNS\-LOG" "7" "June 2018" "CoreDNS" "CoreDNS plugins"
 .
 .SH "NAME"
 \fIlog\fR \- enables query logging to standard output\.
diff --git a/man/coredns-metrics.7 b/man/coredns-metrics.7
index 4678f2d46..0d2e89bef 100644
--- a/man/coredns-metrics.7
+++ b/man/coredns-metrics.7
@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "COREDNS\-METRICS" "7" "May 2018" "CoreDNS" "CoreDNS plugins"
+.TH "COREDNS\-METRICS" "7" "June 2018" "CoreDNS" "CoreDNS plugins"
 .
 .SH "NAME"
 \fIprometheus\fR \- enables Prometheus \fIhttps://prometheus\.io/\fR metrics\.
diff --git a/man/coredns-nsid.7 b/man/coredns-nsid.7
index 3947a1d7a..7dcd9f4c4 100644
--- a/man/coredns-nsid.7
+++ b/man/coredns-nsid.7
@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "COREDNS\-NSID" "7" "May 2018" "CoreDNS" "CoreDNS plugins"
+.TH "COREDNS\-NSID" "7" "June 2018" "CoreDNS" "CoreDNS plugins"
 .
 .SH "NAME"
 \fInsid\fR \- adds an identifier of this server to each reply\.
diff --git a/man/coredns-reload.7 b/man/coredns-reload.7
index a6d44e937..80ba5e73f 100644
--- a/man/coredns-reload.7
+++ b/man/coredns-reload.7
@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "COREDNS\-RELOAD" "7" "May 2018" "CoreDNS" "CoreDNS plugins"
+.TH "COREDNS\-RELOAD" "7" "June 2018" "CoreDNS" "CoreDNS plugins"
 .
 .SH "NAME"
 \fIreload\fR \- allows automatic reload of a changed Corefile
diff --git a/man/coredns-root.7 b/man/coredns-root.7
index bfce08839..bb0bd87ec 100644
--- a/man/coredns-root.7
+++ b/man/coredns-root.7
@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "COREDNS\-ROOT" "7" "May 2018" "CoreDNS" "CoreDNS plugins"
+.TH "COREDNS\-ROOT" "7" "June 2018" "CoreDNS" "CoreDNS plugins"
 .
 .SH "NAME"
 \fIroot\fR \- simply specifies the root of where to find (zone) files\.
diff --git a/man/coredns-route53.7 b/man/coredns-route53.7
index c2b468c32..28f4fa924 100644
--- a/man/coredns-route53.7
+++ b/man/coredns-route53.7
@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "COREDNS\-ROUTE53" "7" "May 2018" "CoreDNS" "CoreDNS plugins"
+.TH "COREDNS\-ROUTE53" "7" "June 2018" "CoreDNS" "CoreDNS plugins"
 .
 .SH "NAME"
 \fIroute53\fR \- enables serving zone data from AWS route53\.
diff --git a/man/coredns-secondary.7 b/man/coredns-secondary.7
index de33575b6..15d5aab34 100644
--- a/man/coredns-secondary.7
+++ b/man/coredns-secondary.7
@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "COREDNS\-SECONDARY" "7" "May 2018" "CoreDNS" "CoreDNS plugins"
+.TH "COREDNS\-SECONDARY" "7" "June 2018" "CoreDNS" "CoreDNS plugins"
 .
 .SH "NAME"
 \fIsecondary\fR \- enables serving a zone retrieved from a primary server\.
diff --git a/man/coredns-tls.7 b/man/coredns-tls.7
index 20aeb0d71..114466083 100644
--- a/man/coredns-tls.7
+++ b/man/coredns-tls.7
@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "COREDNS\-TLS" "7" "May 2018" "CoreDNS" "CoreDNS plugins"
+.TH "COREDNS\-TLS" "7" "June 2018" "CoreDNS" "CoreDNS plugins"
 .
 .SH "NAME"
 \fItls\fR \- allows you to configure the server certificates for the TLS and gRPC servers\.
diff --git a/man/coredns-trace.7 b/man/coredns-trace.7
index 24421ca2c..016dd7671 100644
--- a/man/coredns-trace.7
+++ b/man/coredns-trace.7
@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "COREDNS\-TRACE" "7" "May 2018" "CoreDNS" "CoreDNS plugins"
+.TH "COREDNS\-TRACE" "7" "June 2018" "CoreDNS" "CoreDNS plugins"
 .
 .SH "NAME"
 \fItrace\fR \- enables OpenTracing\-based tracing of DNS requests as they go through the plugin chain\.
diff --git a/man/coredns-whoami.7 b/man/coredns-whoami.7
index 1d10e1ba7..9b0d1cd6a 100644
--- a/man/coredns-whoami.7
+++ b/man/coredns-whoami.7
@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "COREDNS\-WHOAMI" "7" "May 2018" "CoreDNS" "CoreDNS plugins"
+.TH "COREDNS\-WHOAMI" "7" "June 2018" "CoreDNS" "CoreDNS plugins"
 .
 .SH "NAME"
 \fIwhoami\fR \- returns your resolver\'s local IP address, port and transport\.
diff --git a/man/corefile.5 b/man/corefile.5
index caca32544..ebd54cc79 100644
--- a/man/corefile.5
+++ b/man/corefile.5
@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "COREFILE" "5" "May 2018" "CoreDNS" "CoreDNS"
+.TH "COREFILE" "5" "June 2018" "CoreDNS" "CoreDNS"
 .
 .SH "NAME"
 \fBcorefile\fR
@@ -25,22 +25,25 @@ A \fIcorefile\fR specifies the (internal) servers CoreDNS should run and what pl
 .IP "" 0
 .
 .P
-The \fBZONE\fR defines for which name this server should be called, multiple zones are allowed and should be \fIwhite space\fR separated\. You can use a "reverse" syntax to specify a reverse zone (i\.e\. ip6\.arpa and in\-addr\.arpa), but using an IP address in the CIDR notation\. The optional \fBSCHEME\fR defaults to \fBdns://\fR, but can also be \fBtls://\fR (DNS over TLS) or \fBgrpc://\fR (DNS over gRPC)\.
+The \fBZONE\fR defines for which name this server should be called, multiple zones are allowed and should be \fIwhite space\fR separated\. You can use a "reverse" syntax to specify a reverse zone (i\.e\. ip6\.arpa and in\-addr\.arpa), by using an IP address in the CIDR notation\.
 .
 .P
-Specifying a \fBZONE\fR \fIand\fR \fBPORT\fR combination multiple time for \fIdifferent\fR servers will lead to an error on startup\.
+The optional \fBSCHEME\fR defaults to \fBdns://\fR, but can also be \fBtls://\fR (DNS over TLS), \fBgrpc://\fR (DNS over gRPC) or \fBhttps://\fR (DNS over HTTP/2)\.
 .
 .P
-When a query comes in it is matched again all zones for all servers, the server with the longest match on the query name will receive the query\.
+The optional \fBPORT\fR controls on which port the server will bind, this default to 53\. If you use a port number here, you \fIcan\'t\fR override it with \fB\-dns\.port\fR (coredns(1))\.
 .
 .P
-The optional \fBPORT\fR controls on which port the server will bind, this default to 53\. If you use a port number here, you \fIcan\'t\fR override it with \fB\-dns\.port\fR (coredns(1))\.
+Specifying a \fBZONE\fR \fIand\fR \fBPORT\fR combination multiple time for \fIdifferent\fR servers will lead to an error on startup\.
+.
+.P
+When a query comes in, it is matched again all zones for all servers, the server with the longest match on the query name will receive the query\.
 .
 .P
-\fBPLUGIN\fR defines the plugin(s) we want to load into this server\. This is optional as well, but as server with no plugins will just return SERVFAIL for all queries\. Each plugin can have a number of properties than can have arguments, see documentation for each plugin\.
+\fBPLUGIN\fR defines the plugin(s) we want to load into this server\. This is optional as well, but as server with no plugins will just return SERVFAIL for all queries\. Each plugin can have a number of properties than can have arguments, see the documentation for each plugin\.
 .
 .P
-Comments begin with an unquoted hash \fB#\fR and continue to the end of the line\. Comments may be started anywhere on a line\.
+Comments are allowed and begin with an unquoted hash \fB#\fR and continue to the end of the line\. Comments may be started anywhere on a line\.
 .
 .P
 Enviroment variables are supported and either the Unix or Windows form may be used: \fB{$ENV_VAR_1}\fR or \fB{%ENV_VAR_2%}\fR\.