Clarify effect of "directory" configuration option

The "directory" configuration options affects the configuration listed
after the directive but not before which may affect ``include``
directive with relative file paths.

(cherry picked from commit 00ba6967b1a2f52b0216fae30bb26275c6232bfa)

diff --git a/doc/arm/reference.rst b/doc/arm/reference.rst
index 7fd64ec0b90854dc2c8aeb91365bd9a5181d97f8..5a0ad1b91c4024d456d65f18a880cacd4a88a8a9 100644 (file)
--- a/doc/arm/reference.rst
+++ b/doc/arm/reference.rst
@@ -969,6 +969,12 @@ default is used.
    absolute path, and *must* be writable by the effective user ID of the
    ``named`` process.
 
+   The option takes effect only at the time that the configuration
+   option is parsed; if other files are being included before or after specifying the
+   new ``directory``, the ``directory`` option must be listed
+   before any other directive (like ``include``) that can work with relative
+   files. The safest way to include files is to use absolute file names.
+
 ``dnstap``
    ``dnstap`` is a fast, flexible method for capturing and logging DNS
    traffic. Developed by Robert Edmonds at Farsight Security, Inc., and