doc: make -f Makefile.doc (#2919)

mechanical change: create the manual pages.

Signed-off-by: Miek Gieben <miek@miek.nl>
This commit is contained in:
Miek Gieben
2019-06-24 12:37:27 +01:00
committed by Yong Tang
parent e54b784a7e
commit 51cf388da2
36 changed files with 423 additions and 286 deletions

View File

@@ -1,11 +1,11 @@
.\" Generated by Mmark Markdown Processer - mmark.nl
.TH "COREDNS-IMPORT" "7" "April 2019" "CoreDNS" "CoreDNS Plugins"
.TH "COREDNS-IMPORT" 7 "June 2019" "CoreDNS" "CoreDNS Plugins"
.SH NAME
.SH "NAME"
.PP
\fIimport\fP - include files or reference snippets from a Corefile.
.SH DESCRIPTION
.SH "DESCRIPTION"
.PP
The \fIimport\fP plugin can be used to include files into the main configuration. Another use it to
reference predefined snippets. Both can help to avoid some duplication.
@@ -14,7 +14,7 @@ reference predefined snippets. Both can help to avoid some duplication.
This is a unique directive in that \fIimport\fP can appear outside of a server block. In other words, it
can appear at the top of a Corefile where an address would normally be.
.SH SYNTAX
.SH "SYNTAX"
.PP
.RS
@@ -29,13 +29,13 @@ import PATTERN
this line, as if that file's contents appeared here to begin with.
.SH FILES
.SH "FILES"
.PP
You can use \fIimport\fP to include a file or files. This file's location is relative to the
Corefile's location. It is an error if a specific file cannot be found, but an empty glob pattern is
not an error.
.SH SNIPPETS
.SH "SNIPPETS"
.PP
You can define snippets to be reused later in your Corefile by defining a block with a single-token
label surrounded by parentheses:
@@ -63,7 +63,7 @@ import mysnippet
.fi
.RE
.SH EXAMPLES
.SH "EXAMPLES"
.PP
Import a shared configuration:
@@ -104,7 +104,7 @@ import ../zones/*
.fi
.RE
.SH ALSO SEE
.SH "ALSO SEE"
.PP
See corefile(5).