From b25cf127294f5cbdbb314a5919cb3021f792b960 Mon Sep 17 00:00:00 2001
From: Francis Dupont <fdupont@isc.org>
Date: Sun, 14 Oct 2018 19:24:19 +0200
Subject: [PATCH] [5-netconf-doc-config] More about module change subscriptions

---
 doc/guide/netconf.xml | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/doc/guide/netconf.xml b/doc/guide/netconf.xml
index bb4b52e0b0..82e07a5537 100644
--- 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>
-- 
2.47.2