From: Francis Dupont <fdupont@isc.org>
Date: Sat, 24 Nov 2018 14:43:32 +0000 (+0100)
Subject: [65-libyang-simplify-update-models] Tried to address comments
X-Git-Tag: 75-radius-documentation-needs-an-update_base~18
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=d87b6ece1f98e6c9010b5b6a63119e0756b74487;p=thirdparty%2Fkea.git

[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 e24d1be737..f0997ba52e 100644
--- 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 88dc5e3095..5c250a124e 100644
--- 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 277ec595b8..09bea2aaa9 100644
--- 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>