From 3c41fcffb6cb26219c4635146ce0ebe1068f0d60 Mon Sep 17 00:00:00 2001
From: Douglas Bagnall <douglas.bagnall@catalyst.net.nz>
Date: Thu, 30 Apr 2015 11:33:59 +1200
Subject: [PATCH] KCC: improve docstring for KCC.list_dsas()

Signed-off-by: Douglas Bagnall <douglas.bagnall@catalyst.net.nz>
Reviewed-by: Garming Sam <garming@catalyst.net.nz>
Reviewed-by: Andrew Bartlett <abartlet@samba.org>
---
 source4/scripting/bin/samba_kcc | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/source4/scripting/bin/samba_kcc b/source4/scripting/bin/samba_kcc
index 032c3a09732..2a390046cfb 100755
--- a/source4/scripting/bin/samba_kcc
+++ b/source4/scripting/bin/samba_kcc
@@ -2426,6 +2426,16 @@ class KCC(object):
             mydsa.commit_connections(self.samdb)
 
     def list_dsas(self):
+        """Compile a comprehensive list of DSA DNs
+
+        These are all the DSAs on all the sites that KCC would be
+        dealing with.
+
+        This method is not idempotent and may not work correctly in
+        sequence with KCC.run().
+
+        :return: a list of DSA DN strings.
+        """
         self.load_my_site()
         self.load_my_dsa()
 
-- 
2.47.3