Explain the condition that must be true for the adding of auth zones and

forwarding zones.

Fixes #5376, though the code could use some proper use checking as well.

diff --git a/pdns/recursordist/docs/http-api/zone.rst b/pdns/recursordist/docs/http-api/zone.rst
index 71611cf3c527c29bd4acbdec9e8a89442ac4fdbd..3de3f069c8a86bff2aa1228655205844513e2038 100644 (file)
--- a/pdns/recursordist/docs/http-api/zone.rst
+++ b/pdns/recursordist/docs/http-api/zone.rst
@@ -23,4 +23,16 @@ Comments are per-RRset.
   :property [str] servers: For zones of type "Forwarded", addresses to send the queries to
   :property bool recursion_desired: For zones of type "Forwarded", Whether or not the RD bit should be set in the query
 
+To properly process new zones, the following conditions must
+be true:
+
+* ``forward-zones``, ``forward-zones-recurse`` and/or ``auth-zones``
+  settings must be set (possibly to the empty string) in a
+  configuration file. These settings must not be overriden on the
+  command line. Setting these options on the command line will
+  override what has been set in the dynamically generated
+  configuration files.
+* ``include-dir`` must refer to the same directory as
+  ``api-config-dir`` for the dynamic reloading to work.
+
 .. include:: ../common/api/zone.rst