From 5299dfb7f794c175df9d5989b6a0bdabd4094020 Mon Sep 17 00:00:00 2001
From: Pierre-Louis LAUNAY <pierre-louis.launay@digitas.fr>
Date: Fri, 22 Feb 2013 15:10:17 +0100
Subject: [PATCH] More explanation about move events

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

diff --git a/en/reference/events.rst b/en/reference/events.rst
index 7693af5..c9bedb2 100644
--- a/en/reference/events.rst
+++ b/en/reference/events.rst
@@ -146,3 +146,18 @@ Listening to Lifecycle Events
 -----------------------------
 
 This works exactly the same as with the `ORM events <http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/reference/events.html>`_.
+
+Move events
+-----------
+
+When I move a document, the document is not be modified, except the ID.
+The preFlush and onFlush events may modify the document before moving the document.
+
+When $dm->flush is calling after $dm->move(), the order of events is:
+
+1. preFlush
+2. onFlush
+3. preMove
+4. postMove
+5. postFlush
+