diff --git a/doc/arm/Bv9ARM-book.xml b/doc/arm/Bv9ARM-book.xml
index c8eec62d4e..a0e195efd1 100644
--- a/doc/arm/Bv9ARM-book.xml
+++ b/doc/arm/Bv9ARM-book.xml
@@ -12459,19 +12459,41 @@ example.com. NS ns2.example.net.
mirror
- If set to yes, causes the
+ If set to yes, this causes the
zone to become a mirror zone. A mirror zone is a
- slave zone whose every
- version is subject to DNSSEC validation before being
- used. In order for zone validation to succeed, its
- KSK must be configured as a trust anchor. Answers
- coming from a mirror zone look almost exactly like
- answers from a regular slave
- zone, with the notable exception of the AA bit not
- being set. The default is no.
- This option is meant to be used for deploying an RFC
- 7706-style local copy of the root zone, e.g. using a
- configuration like this:
+ secondary zone whose data
+ is subject to DNSSEC validation before being
+ used in answers. The default is
+ no.
+
+
+ A mirror zone's contents are validated during the transfer
+ process, and again when the zone file is loaded from disk
+ when named is restarted. If validation
+ fails, a retransfer of the zone is scheduled; if the mirror
+ zone had not previously been loaded or if the previous
+ version has expired, traditional DNS recursion will be used
+ to look up the answers instead.
+
+
+ For validation to succeed, a key-signing key (KSK) for
+ the zone must be configured as a trust anchor in
+ named.conf:
+ that is, a key for the zone must either be specified in
+ managed-keys or
+ trusted-keys, or in the case of
+ the root zone, dnssec-validation
+ must be set to auto.
+ Answers coming from a mirror zone look almost exactly like
+ answers from a normal slave zone, with the notable
+ exceptions that the AA bit ("authoritative answer") is
+ not set, and the AD bit ("authenticated data") is.
+
+
+ Though this option can be used for other zones, it
+ is intended to be used to set up a fast local copy of
+ the root zone, as described in RFC 7706.
+ This can be done by using the following configuration:
zone "." {
type slave;
diff --git a/doc/arm/notes.xml b/doc/arm/notes.xml
index e69b0af0bd..b6c3fdbfc7 100644
--- a/doc/arm/notes.xml
+++ b/doc/arm/notes.xml
@@ -82,11 +82,12 @@
A new secondary zone option, mirror,
enables named to serve a transferred copy
of a zone's contents without acting as an authority for the
- zone. DNS responses from mirror zones do not set the AA
- ("authoritative answer") bit, and are subject to DNSSEC
- validation. This is meant to facilitate deployment
- of a local copy of the root zone as described in RFC 7706.
- [GL #33]
+ zone. A zone must be fully validated against an active trust
+ anchor before it can be used as a mirror zone. DNS responses
+ from mirror zones do not set the AA bit ("authoritative answer"),
+ but do set the AD bit ("authenticated data"). This feature is
+ meant to facilitate deployment of a local copy of the root zone,
+ as described in RFC 7706. [GL #33]