diff --git a/doc/arm/Bv9ARM-book.xml b/doc/arm/Bv9ARM-book.xml
index b313840324..f79264a873 100644
--- a/doc/arm/Bv9ARM-book.xml
+++ b/doc/arm/Bv9ARM-book.xml
@@ -5809,30 +5809,55 @@ options {
minimal-responses
- If set to yes, then when generating
- responses the server will only add records to the authority
- and additional data sections when they are required (e.g.
- delegations, negative responses). This may improve the
- performance of the server.
+ This option controls the addition of records to the
+ authority and additional sections of responses. Such
+ records may be included in responses to be helpful
+ to clients; for example, NS or MX records may
+ have associated address records included in the additional
+ section, obviating the need for a separate address lookup.
+ However, adding these records to responses is not mandatory
+ and requires additional database lookups, causing extra
+ latency when marshalling responses.
+ minimal-responses takes one of
+ four values:
+
+
+
+ no: the server will be
+ as complete as possible when generating responses.
+
+
+ yes: the server will only add
+ records to the authority and additional sections when
+ such records are required by the DNS protocol (for
+ example, when returning delegations or negative
+ responses). This provides the best server performance
+ but may result in more client queries.
+
+
+ no-auth: the server
+ will omit records from the authority section except
+ when they are required, but it may still add records
+ to the additional section.
+
+
+ no-auth-recursive: the same
+ as no-auth when recursion is
+ requested in the query (RD=1), or the same as
+ no if recursion is not
+ requested.
+
+
+
+ no-auth and
+ no-auth-recursive are useful when
+ answering stub clients, which usually ignore the
+ authority section. no-auth-recursive
+ is meant for use in mixed-mode servers that handle both
+ authoritative and recursive queries.
- When set to no-auth, the
- server will omit records from the authority section
- unless they are required, but it may still add
- records to the additional section. When set to
- no-auth-recursive, this
- is only done if the query is recursive. When the
- query is not recursive, the effect is same as if
- no was specified. These
- settings are useful when answering stub clients,
- which usually ignore the authority section.
- no-auth-recursive is
- designed for mixed-mode servers which handle
- both authoritative and recursive queries.
-
-
- The default is
- no-auth-recursive.
+ The default is no-auth-recursive.