From: Peter Thomassen <peter@desec.io>
Date: Fri, 16 Sep 2016 17:50:59 +0000 (-0300)
Subject: docs: clarify SOA-EDIT-API
X-Git-Tag: rec-4.1.0-alpha1~328^2~3
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=908bf8a70858ecc1d7a8eff8c98633197a71741c;p=thirdparty%2Fpdns.git

docs: clarify SOA-EDIT-API
---

diff --git a/docs/markdown/httpapi/api_spec.md b/docs/markdown/httpapi/api_spec.md
index 02d5517c2c..1b988882b6 100644
--- a/docs/markdown/httpapi/api_spec.md
+++ b/docs/markdown/httpapi/api_spec.md
@@ -384,7 +384,10 @@ Where `Comment` is defined as:
 * `soa_edit_api` MAY be set. If it is set, on changes to the contents of
   a zone made through the API, the SOA record will be edited according to
   the SOA-EDIT-API rules. (Which are the same as the SOA-EDIT-DNSUPDATE rules.)
-  If not set at all during zone creation, defaults to `DEFAULT`.
+  If not set during zone creation, a SOA-EDIT-API metadata record is created
+  and set to `DEFAULT`. (If this record is removed from the backend, the
+  default behaviour is to not do any SOA editing based on this setting. This
+  is different from setting `DEFAULT`.)
   **Note**: Authoritative only.
 
 * `account` MAY be set. Its value is defined by local policy.