@@ -214,15 +214,17 @@ The ``OBJECT_TO_POPULATE`` is only used for the top level object. If that object
214214is the root of a tree structure, all child elements that exist in the
215215normalized data will be re-created with new instances.
216216
217- ..versionadded:: 4.3
217+ When the ``AbstractObjectNormalizer::DEEP_OBJECT_TO_POPULATE `` option is set to
218+ true, existing children of the root ``OBJECT_TO_POPULATE `` are updated from the
219+ normalized data, instead of the denormalizer re-creating them. Note that
220+ ``DEEP_OBJECT_TO_POPULATE `` only works for single child objects, but not for
221+ arrays of objects. Those will still be replaced when present in the normalized
222+ data.
218223
219- Symfony 4.3 introduces a new option ``AbstractObjectNormalizer::DEEP_OBJECT_TO_POPULATE ``.
220- When this flag is set to true, existing children of the root ``OBJECT_TO_POPULATE `` are
221- updated from the normalized data, instead of the denormalizer re-creating them.
224+ ..versionadded ::4.3
222225
223- Note that ``DEEP_OBJECT_TO_POPULATE `` only works for single child objects,
224- but not for arrays of objects. Those will still be replaces when present in
225- the normalized data.
226+ The ``AbstractObjectNormalizer::DEEP_OBJECT_TO_POPULATE `` option was
227+ introduced in Symfony 4.3.
226228
227229.. _component-serializer-attributes-groups :
228230