From: Vladimír Čunát <vladimir.cunat@nic.cz>
Date: Fri, 24 Mar 2017 10:42:30 +0000 (+0100)
Subject: config docs: add examples to mode()
X-Git-Tag: v1.2.5~6^2~2^2~6^2
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=91c912ff1d4d2aa1aac8ee510b5a76a8bb334ae8;p=thirdparty%2Fknot-resolver.git

config docs: add examples to mode()

Improved by comments from Petr.
---

diff --git a/daemon/README.rst b/daemon/README.rst
index aa8990179..604c1d604 100644
--- a/daemon/README.rst
+++ b/daemon/README.rst
@@ -393,11 +393,16 @@ Environment
    by DNSSEC, some of the strict checking actions are counter-productive.
 
    .. csv-table::
-    :header: "Action", "Modes"
+    :header: "Glue type", "Modes when it is accepted",   "Example glue [#example_glue]_"
 
-    "Use mandatory glue", "strict, normal, permissive"
-    "Use in-bailiwick glue", "normal, permissive"
-    "Use any glue records", "permissive"
+    "mandatory glue",     "strict, normal, permissive",  "ns1.example.org"
+    "in-bailiwick glue",  "normal, permissive",          "ns1.example2.org"
+    "any glue records",   "permissive",                  "ns1.example3.net"
+
+   .. [#example_glue] The examples show glue records acceptable from servers
+        authoritative for `org` zone when delegating to `example.org` zone.
+        Unacceptable or missing glue records trigger resolution of names listed
+        in NS records before following respective delegation.
 
 .. function:: reorder_RR([true | false])