mirror of
https://github.com/coredns/coredns.git
synced 2026-02-08 16:33:09 -05:00
docs: Regenerate all manpages using mmark (#2762)
Mmark recently became able to create manual pages. This removed the dependency on 'ronn' and just uses mmark (Go program). Re-hookup Makefile.doc to generate the correct header mmark needs to see and regenate them all. Spot checking a few pages suggest they look good and actually better than rendered with ronn, esp. lists in lists. Fixes #2757 Signed-off-by: Miek Gieben <miek@miek.nl>
This commit is contained in:
@@ -1,73 +1,78 @@
|
||||
.\" generated with Ronn/v0.7.3
|
||||
.\" http://github.com/rtomayko/ronn/tree/0.7.3
|
||||
.
|
||||
.TH "COREDNS\-FEDERATION" "7" "March 2019" "CoreDNS" "CoreDNS plugins"
|
||||
.
|
||||
.SH "NAME"
|
||||
\fIfederation\fR \- enables federated queries to be resolved via the kubernetes plugin\.
|
||||
.
|
||||
.SH "DESCRIPTION"
|
||||
Enabling this plugin allows Federated \fIhttps://kubernetes\.io/docs/tasks/federation/federation\-service\-discovery/\fR queries to be resolved via the kubernetes plugin\.
|
||||
.
|
||||
.P
|
||||
Enabling \fIfederation\fR without also having \fIkubernetes\fR is a noop\.
|
||||
.
|
||||
.SH "SYNTAX"
|
||||
.
|
||||
.nf
|
||||
.\" Generated by Mmark Markdown Processer - mmark.nl
|
||||
.TH "COREDNS-FEDERATION" "7" "April 2019" "CoreDNS" "CoreDNS Plugins"
|
||||
|
||||
federation [ZONES\.\.\.] {
|
||||
.SH FEDERATION
|
||||
.SH NAME
|
||||
.PP
|
||||
\fIfederation\fP - enables federated queries to be resolved via the kubernetes plugin.
|
||||
|
||||
.SH DESCRIPTION
|
||||
.PP
|
||||
Enabling this plugin allows
|
||||
Federated
|
||||
\[la]https://kubernetes.io/docs/tasks/federation/federation-service-discovery/\[ra] queries to be
|
||||
resolved via the kubernetes plugin.
|
||||
|
||||
.PP
|
||||
Enabling \fIfederation\fP without also having \fIkubernetes\fP is a noop.
|
||||
|
||||
.SH SYNTAX
|
||||
.PP
|
||||
.RS
|
||||
|
||||
.nf
|
||||
federation [ZONES...] {
|
||||
NAME DOMAIN
|
||||
upstream
|
||||
}
|
||||
.
|
||||
.fi
|
||||
.
|
||||
.IP "\(bu" 4
|
||||
Each \fBNAME\fR and \fBDOMAIN\fR defines federation membership\. One entry for each\. A duplicate \fBNAME\fR will silently overwrite any previous value\.
|
||||
.
|
||||
.IP "\(bu" 4
|
||||
\fBupstream\fR [\fBADDRESS\fR\.\.\.] resolve the \fBCNAME\fR target produced by this plugin\. CoreDNS will resolve External Services against itself\.
|
||||
.
|
||||
.IP "" 0
|
||||
.
|
||||
.SH "EXAMPLES"
|
||||
Here we handle all service requests in the \fBprod\fR and \fBstage\fR federations\.
|
||||
.
|
||||
.IP "" 4
|
||||
.
|
||||
.nf
|
||||
|
||||
\&\. {
|
||||
kubernetes cluster\.local
|
||||
federation cluster\.local {
|
||||
prod prod\.feddomain\.com
|
||||
staging staging\.feddomain\.com
|
||||
.fi
|
||||
.RE
|
||||
|
||||
.IP \(bu 4
|
||||
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.
|
||||
|
||||
|
||||
.SH EXAMPLES
|
||||
.PP
|
||||
Here we handle all service requests in the \fB\fCprod\fR and \fB\fCstage\fR federations.
|
||||
|
||||
.PP
|
||||
.RS
|
||||
|
||||
.nf
|
||||
\&. {
|
||||
kubernetes cluster.local
|
||||
federation cluster.local {
|
||||
prod prod.feddomain.com
|
||||
staging staging.feddomain.com
|
||||
upstream
|
||||
}
|
||||
}
|
||||
.
|
||||
.fi
|
||||
.
|
||||
.IP "" 0
|
||||
.
|
||||
.P
|
||||
Or slightly shorter:
|
||||
.
|
||||
.IP "" 4
|
||||
.
|
||||
.nf
|
||||
|
||||
cluster\.local {
|
||||
.fi
|
||||
.RE
|
||||
|
||||
.PP
|
||||
Or slightly shorter:
|
||||
|
||||
.PP
|
||||
.RS
|
||||
|
||||
.nf
|
||||
cluster.local {
|
||||
kubernetes
|
||||
federation {
|
||||
prod prod\.feddomain\.com
|
||||
staging staging\.feddomain\.com
|
||||
prod prod.feddomain.com
|
||||
staging staging.feddomain.com
|
||||
upstream
|
||||
}
|
||||
}
|
||||
.
|
||||
.fi
|
||||
.
|
||||
.IP "" 0
|
||||
|
||||
.fi
|
||||
.RE
|
||||
|
||||
|
||||
Reference in New Issue
Block a user