From: Andrew Bartlett <abartlet@samba.org>
Date: Thu, 8 Feb 2018 03:46:29 +0000 (+1300)
Subject: python/samdb: Improve function comment on normalize_dn_in_domain()
X-Git-Tag: tevent-0.9.36~212
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=f202b0ef24ded7e93b986033473bc5cf260be33d;p=thirdparty%2Fsamba.git

python/samdb: Improve function comment on normalize_dn_in_domain()

Signed-off-by: Andrew Bartlett <abartlet@samba.org>
Reviewed-by: Douglas Bagnall <douglas.bagnall@catalyst.net.nz>
---

diff --git a/python/samba/samdb.py b/python/samba/samdb.py
index f4e97dc0c01..d1048a74e14 100644
--- a/python/samba/samdb.py
+++ b/python/samba/samdb.py
@@ -999,10 +999,13 @@ accountExpires: %u
         return dsdb._dsdb_allocate_rid(self)
 
     def normalize_dn_in_domain(self, dn):
-        """return full dn of an relative dn
+        '''return a new DN expanded by adding the domain DN
+
+        If the dn is already a child of the domain DN, just
+        return it as-is.
 
         :param dn: relative dn
-        """
+        '''
         domain_dn = ldb.Dn(self, self.domain_dn())
 
         if isinstance(dn, ldb.Dn):