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 f4e97dc0c0195efd43c529818a781f7774cc79de..d1048a74e14f459d944ebec1a92a1d62f031a267 100644 (file)
--- 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):