From 20f96cc9d35e23fc3bfcd1671878c18e0acea618 Mon Sep 17 00:00:00 2001
From: Eric GELOEN <geloen.eric@gmail.com>
Date: Thu, 26 Jun 2014 18:08:39 +0200
Subject: [PATCH] [DDC-3179] Document postRemove limitation

---
 docs/en/reference/events.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/docs/en/reference/events.rst b/docs/en/reference/events.rst
index f315f66b1..0990315ec 100644
--- a/docs/en/reference/events.rst
+++ b/docs/en/reference/events.rst
@@ -191,6 +191,12 @@ the life-time of their registered entities.
     safe to access associations in a postLoad callback or event
     handler.
 
+.. warning::
+
+    Note that the postRemove event or any events triggered after an entity removal
+    can receive an uninitializable proxy in case you have configured an entity to
+    cascade remove relations. In this case, you should load yourself the proxy in
+    the associated pre event.
 
 You can access the Event constants from the ``Events`` class in the
 ORM package.