[5-netconf-doc-config] More about module change subscriptions

diff --git a/doc/guide/netconf.xml b/doc/guide/netconf.xml
index bb4b52e0b05b9929a8f2e2c54396ac03c3d8e0e5..82e07a5537c57509b22797dd302b4ce9c1604578 100644 (file)
--- a/doc/guide/netconf.xml
+++ b/doc/guide/netconf.xml
@@ -310,6 +310,19 @@ ietf-dhcpv6-types          | 2018-01-30 | Imported    |                     |
       they must be copied to the startup datastore.
     </para>
 
+    <para>
+      When a module change callback is subscribed and the running
+      configuration is changed (using <command>sysrepocfg</command>)
+      the callback is called to validate the modified configuration
+      (if <command>validate-changes</command> was not set to false)
+      and a second time to apply it. If the validation failed the
+      callback is still called again but with an ABORT (vs APPLY) event
+      with rollback changes.
+
+      The returned code of the callback on an APPLY event is ignored,
+      i.e. it is too late to refuse a bad configuration.
+    </para>
+
     <para>
       A modified YANG configuration has four ways to be incorrect:
       <orderedlist>