Doc update (#2792)

* Fix spelling in coredns.1 and corefile.7 md files
* Run make -f Makefile.doc

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

man/coredns-federation.7

@@ -1,11 +1,11 @@
 .\" Generated by Mmark Markdown Processer - mmark.nl
-.TH "COREDNS-FEDERATION" "7" "April 2019" "CoreDNS" "CoreDNS Plugins"
+.TH "COREDNS-FEDERATION" 7 "April 2019" "CoreDNS" "CoreDNS Plugins"
 
-.SH NAME
+.SH "NAME"
 .PP
 \fIfederation\fP - enables federated queries to be resolved via the kubernetes plugin.
 
-.SH DESCRIPTION
+.SH "DESCRIPTION"
 .PP
 Enabling this plugin allows
 Federated
@@ -15,7 +15,7 @@ resolved via the kubernetes plugin.
 .PP
 Enabling \fIfederation\fP without also having \fIkubernetes\fP is a noop.
 
-.SH SYNTAX
+.SH "SYNTAX"
 .PP
 .RS
 
@@ -32,11 +32,12 @@ federation [ZONES...] {
 Each \fBNAME\fP and \fBDOMAIN\fP defines federation membership. One entry for each. A duplicate
 \fBNAME\fP will silently overwrite any previous value.
 .IP \(bu 4
-\fB\fCupstream\fR [\fBADDRESS\fP...] resolve the \fB\fCCNAME\fR target produced by this plugin.  CoreDNS
-will resolve External Services against itself.
+\fB\fCupstream\fR resolve the \fB\fCCNAME\fR target produced by this plugin.  CoreDNS
+will resolve External Services against itself and needs the \fIforward\fP plugin to be active to do
+so.
 
 
-.SH EXAMPLES
+.SH "EXAMPLES"
 .PP
 Here we handle all service requests in the \fB\fCprod\fR and \fB\fCstage\fR federations.
 
@@ -51,25 +52,7 @@ Here we handle all service requests in the \fB\fCprod\fR and \fB\fCstage\fR fede
         staging staging.feddomain.com
         upstream
     }
-}
-
-.fi
-.RE
-
-.PP
-Or slightly shorter:
-
-.PP
-.RS
-
-.nf
-cluster.local {
-    kubernetes
-    federation {
-        prod prod.feddomain.com
-        staging staging.feddomain.com
-        upstream
-    }
+    forward . 192.168.1.12
 }
 
 .fi