diff --git a/spring-ldap/docs/reference/src/transactions.xml b/spring-ldap/docs/reference/src/transactions.xml
index d21896a5..b456e277 100644
--- a/spring-ldap/docs/reference/src/transactions.xml
+++ b/spring-ldap/docs/reference/src/transactions.xml
@@ -202,7 +202,15 @@
subtreeNode is ou=tempEntries and the original DN of the entry is
cn=john doe, ou=users, the temporary DN will be cn=john doe, ou=tempEntries.
Note that the configured subtree node needs to be present in the LDAP tree.
-
+
+
+ There are some situations where the DefaultTempEntryRenamingStrategy will not work. E.g. if your are planning
+ to do recursive deletes you'll need to use DifferentSubtreeTempEntryRenamingStrategy. This is because
+ the recursive delete operation actually consists of a depth-first delete of each node in the sub tree individually.
+ Since it is not allowed to rename an entry that has any children, and DefaultTempEntryRenamingStrategy would
+ leave each node in the same subtree (with a different name) in stead of actually removing it, this operation would fail.
+ When in doubt, use DifferentSubtreeTempEntryRenamingStrategy.
+
\ No newline at end of file