[65-libyang-simplify-update-models] Tried to address comments

diff --git a/doc/examples/kea4/all-keys.json b/doc/examples/kea4/all-keys.json
index e24d1be73788e0a58d466b60c2e9bbe7793fc658..f0997ba52e8a4656634c71cd2086ecbe6efe9e2e 100644 (file)
--- a/doc/examples/kea4/all-keys.json
+++ b/doc/examples/kea4/all-keys.json
@@ -661,7 +661,8 @@
         // Global valid lifetime value.
         "valid-lifetime": 6000,
 
-        // Configuration control.
+        // Configuration control (currently not used, i.e. this syntax
+        // is already defined but corresponding feature is not implemented).
         "config-control":
         {
             // Only configuration databases entry is defined.

diff --git a/doc/examples/kea6/all-keys.json b/doc/examples/kea6/all-keys.json
index 88dc5e3095d8fe9cd857b344db23f1b3a3ae3a70..5c250a124e68edcc460d46904d2d9a0ac7fc5261 100644 (file)
--- a/doc/examples/kea6/all-keys.json
+++ b/doc/examples/kea6/all-keys.json
@@ -617,7 +617,8 @@
         // Global valid lifetime value.
         "valid-lifetime": 6000,
 
-        // Configuration control.
+        // Configuration control (currently not used, i.e. this syntax
+        // is already defined but corresponding feature is not implemented).
         "config-control":
         {
             // Only configuration databases entry is defined.

diff --git a/doc/guide/netconf.xml b/doc/guide/netconf.xml
index 277ec595b867d1d9459f7477af536474c276d8f6..09bea2aaa9c7e5a03c5132c6558bbd18bfe0366c 100644 (file)
--- a/doc/guide/netconf.xml
+++ b/doc/guide/netconf.xml
@@ -75,6 +75,18 @@
     notes made during a series of IETF Hackathons</uri>.
     </para>
 
+    <para>
+    In YANG configurations and state data are described in the YANG syntax
+    in module files named:
+<userinput>"module-name"</userinput><option>[@<userinput>"revision"</userinput>]</option>.yang
+    </para>
+
+    <para>
+    The revision part is optional and has YYYY-MM-DD format. An alternate
+    XML syntax YIN is defined but less user friendly. Top level modules
+    are named in kea models (short version of schema models).
+    </para>
+
     <para>
       List currently installed YANG modules:
 <screen>
@@ -174,7 +186,17 @@ ietf-dhcpv6-server         | 2018-03-04 | Installed   | root:root           | 66
 ietf-dhcpv6-options        | 2018-03-04 | Imported    |                     |             |                               |
 ietf-dhcpv6-types          | 2018-01-30 | Imported    |                     |             |                               |
 </screen>
-</para>
+    </para>
+
+    <para>
+To install a new revision of a module it must be first uninstalled, e.g. by:
+<screen>
+sudo sysrepoctl -u -m kea-dhcp4-server
+</screen>
+If the module is used (i.e. imported) by other modules it can be unstalled
+only after modules using it, i.e. installation and uninstallation must be
+done in dependency order and reverse dependency order.
+    </para>
 
   </section>