ldb-samba: Explain the current behaviour of ldif_canonicalise_objectCategory

diff --git a/lib/ldb-samba/ldif_handlers.c b/lib/ldb-samba/ldif_handlers.c
index bb5232a8f59a6fad1dcf86c69ffece053e0ce860..ca6fa74b009c42e292e0ac5a519326bea65ceea2 100644 (file)
--- a/lib/ldb-samba/ldif_handlers.c
+++ b/lib/ldb-samba/ldif_handlers.c
@@ -449,8 +449,13 @@ static int ldif_write_sddlSecurityDescriptor(struct ldb_context *ldb, void *mem_
 }
 
 /* 
-   canonicalise an objectCategory.  We use the short form as the canonical form:
-   cn=Person,cn=Schema,cn=Configuration,<basedn> becomes 'person'
+   canonicalise an objectCategory.  We use the long form as the canonical form:
+   'person' becomes cn=Person,cn=Schema,cn=Configuration,<basedn>
+
+   Also any short name of an objectClass that points to a different
+   class (such as user) has the canonical form of the class it's
+   defaultObjectCategory points to (eg
+   cn=Person,cn=Schema,cn=Configuration,<basedn>)
 */
 
 static int ldif_canonicalise_objectCategory(struct ldb_context *ldb, void *mem_ctx,