docs: rewrite using manpage style (#327)

This still needs cleanup, but this is a first pass the cleans some
cruft and documents our style (in middleware.md) and makes all the
docs match that style.
This commit is contained in:
Miek Gieben
2016-10-10 20:13:22 +01:00
committed by GitHub
parent c22b7b2252
commit faf83b00dd
18 changed files with 154 additions and 128 deletions

View File

@@ -1,14 +1,14 @@
# dnssec
`dnssec` enables on-the-fly DNSSEC signing of served data.
*dnssec* enables on-the-fly DNSSEC signing of served data.
## Syntax
~~~
dnssec [zones...]
dnssec [ZONES...]
~~~
* `zones` zones that should be signed. If empty, the zones from the configuration block
* **ZONES** zones that should be signed. If empty, the zones from the configuration block
are used.
If keys are not specified (see below), a key is generated and used for all signing operations. The
@@ -23,10 +23,9 @@ NOTE: Key generation has not been implemented yet.
TODO(miek): think about key rollovers, and how to do them automatically.
~~~
dnssec [zones... ] {
key file [key...]
dnssec [ZONES... ] {
key file KEY...
}
~~~