Merge branch '4.4' into 5.0

javiereguiluz · javiereguiluz · commit 36eac11bcabf · 2020-03-16T08:53:19.000+01:00
* 4.4:
  [Form] Better explicit cloning with "by_reference" option
diff --git a/reference/forms/types/options/by_reference.rst.inc b/reference/forms/types/options/by_reference.rst.inc
@@ -41,8 +41,8 @@ If you set ``by_reference`` to false, submitting looks like this::
     $author->setEmail('...');
     $article->setAuthor($author);
 
-So, all that ``by_reference=false`` really does is force the framework to
-call the setter on the parent object.
+So, all that ``by_reference=false`` really does is that it clones the object,
+which enforces the framework to call the setter on the parent object.
 
 Similarly, if you're using the :doc:`CollectionType </reference/forms/types/collection>`
 field where your underlying collection data is an object (like with
