samba-tool/dns: Clarify the cleanup subcommand

Signed-off-by: Garming Sam <garming@catalyst.net.nz>
Reviewed-by: Douglas Bagnall <douglas.bagnall@catalyst.net.nz>

diff --git a/python/samba/netcmd/dns.py b/python/samba/netcmd/dns.py
index 04c3d8bf2d18abf3ba20980e2e114426b987de65..33f81ee7fcad4631df29d039d1a47f66c54b7cef 100644 (file)
--- a/python/samba/netcmd/dns.py
+++ b/python/samba/netcmd/dns.py
@@ -1080,8 +1080,9 @@ class cmd_cleanup_record(Command):
 
         samba-tool dns cleanup dc1 dc1.samdom.test.site -U USER%PASSWORD
 
-    NOTE: This command doesn't delete the DNS records,
-    it only mark the `dNSTombstoned` attr as `TRUE`.
+    NOTE: This command in many cases will only mark the `dNSTombstoned` attr
+    as `TRUE` on the DNS records. Querying will no longer return results but
+    there may still be some placeholder entries in the database.
     """
 
     synopsis = '%prog <server> <dnshostname>'