From f3909ae88527aa254970b63f30f68272c1e1cbdb Mon Sep 17 00:00:00 2001 From: Thomas Landauer Date: Fri, 23 Dec 2016 20:09:25 +0100 Subject: [PATCH] Update working-with-associations.rst --- .../reference/working-with-associations.rst | 24 ++++--------------- 1 file changed, 5 insertions(+), 19 deletions(-) diff --git a/docs/en/reference/working-with-associations.rst b/docs/en/reference/working-with-associations.rst index 21f1fa356..d1d7b4265 100644 --- a/docs/en/reference/working-with-associations.rst +++ b/docs/en/reference/working-with-associations.rst @@ -405,25 +405,11 @@ There are two approaches to handle this problem in your code: Transitive persistence / Cascade Operations ------------------------------------------- -Persisting, removing, detaching, refreshing and merging individual entities can -become pretty cumbersome, especially when a highly interweaved object graph -is involved. Therefore Doctrine 2 provides a -mechanism for transitive persistence through cascading of these -operations. Each association to another entity or a collection of -entities can be configured to automatically cascade certain -operations. By default, no operations are cascaded. - -The following cascade options exist: - - -- persist : Cascades persist operations to the associated - entities. -- remove : Cascades remove operations to the associated entities. -- merge : Cascades merge operations to the associated entities. -- detach : Cascades detach operations to the associated entities. -- refresh : Cascades refresh operations to the associated entities. -- all : Cascades persist, remove, merge, refresh and detach operations to - associated entities. +When working with many associated entities, you sometimes don't want to "expose" all entities to your PHP application. +Therefore Doctrine 2 provides a mechanism for transitive persistence through cascading of certain operations. +Each association to another entity or a collection of +entities can be configured to automatically cascade the following operations to the associated entities: +``persist``, ``remove``, ``merge``, ``detach``, ``refresh`` or ``all``. .. note::