From 73b10a1eed2dda81c53cd1e45d9e9febc7de524a Mon Sep 17 00:00:00 2001
From: Tomek Mrugalski <tomasz@isc.org>
Date: Sat, 21 Oct 2017 18:24:58 +0100
Subject: [PATCH] [5396] Doc updated

---
 doc/guide/hooks.xml | 18 ++++++++++++++++--
 1 file changed, 16 insertions(+), 2 deletions(-)

diff --git a/doc/guide/hooks.xml b/doc/guide/hooks.xml
index fb9dce08c4..46bf9f42f6 100644
--- a/doc/guide/hooks.xml
+++ b/doc/guide/hooks.xml
@@ -2085,6 +2085,12 @@ If the subnet exists the response will be similar to this:
           new subnet. Thus, we recommend that this command is used with extreme
           caution.
         </para>
+        <para>
+          This command can also be used to completely delete an IPv4 subnet that
+          is part of a shared network. If you want to simply remove the subnet
+          from a shared network and keep the subnet configuration, use
+          <command>network4-subnet-del</command> command instead.
+        </para>
 
         <para>The command has the following structure:
 <screen>
@@ -2139,6 +2145,12 @@ If the subnet exists the response will be similar to this:
           new subnet. Thus, we recommend that this command is used with extreme
           caution.
         </para>
+        <para>
+          This command can also be used to completely delete an IPv6 subnet that
+          is part of a shared network. If you want to simply remove the subnet
+          from a shared network and keep the subnet configuration, use
+          <command>network6-subnet-del</command> command instead.
+        </para>
 
         <para>The command has the following structure:
 <screen>
@@ -2432,8 +2444,10 @@ both the command and the response.
         <title>network4-subnet-del, network6-subnet-del commands</title>
         <para>
           These commands are used to remove a subnet that is part of existing shared
-          network and demote it to a plain, stand-alone subnet.  The
-          <command>network4-subnet-del</command> and
+          network and demote it to a plain, stand-alone subnet. If you want to
+          remove a subnet completely, use <command>subnet4-del</command> or
+          <command>subnet6-del</command> commands instead.
+          The <command>network4-subnet-del</command> and
           <command>network6-subnet-del</command> commands take two parameters:
           <command>id</command>, which is an integer and specifies subnet-id of
           existing subnet to be removed from a shared network; and
-- 
2.47.2