KCC: improve docstring for KCC.translate_ntdsconn()

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>

1 files changed, 8 insertions, 2 deletions

diff --git a/source4/scripting/bin/samba_kcc b/source4/scripting/bin/samba_kcc
index 11ed6dabcc7..11798f39a5f 100755
--- a/source4/scripting/bin/samba_kcc
+++ b/source4/scripting/bin/samba_kcc
@@ -906,10 +906,16 @@ class KCC(object):
             return False, None
 
     def translate_ntdsconn(self, current_dsa=None):
-        """This function adjusts values of repsFrom abstract attributes of NC
+        """Adjust repsFrom to match NTDSConnections
+
+        This function adjusts values of repsFrom abstract attributes of NC
         replicas on the local DC to match those implied by
         nTDSConnection objects.
-        [MS-ADTS] 6.2.2.5
+
+        Based on [MS-ADTS] 6.2.2.5
+
+        :param current_dsa: optional DSA on whose behalf we are acting.
+        :return: None
         """
         count = 0