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.

diff --git a/doc/arm/reference.rst b/doc/arm/reference.rst
index a3a75ded5b3af12bc0dd1c8f24ad10f6003806ca..66349ea2f8322cc4cbff779bc39c60bcb2e6c4b8 100644 (file)
--- a/doc/arm/reference.rst
+++ b/doc/arm/reference.rst
@@ -988,6 +988,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