/**
* Merges the state of a detached entity into the persistence context
* of this EntityManager and returns the managed copy of the entity.
* The entity passed to merge will not become associated/managed with this EntityManager.
*
*
@param object $entity The detached entity to merge into the persistence context.
*
*
@return object The managed copy of the entity.
*
*
@throws ORMInvalidArgumentException
*
@throws ORMException
*
*
@deprecated 2.7 This method is being removed from the ORM and won't have any replacement
*/
public function merge($entity)