Deprecate repositories' magic findBy and findOneBy

Author: malarzm

docs/en/reference/document-repositories.rst

@@ -46,6 +46,11 @@ with Doctrine's Criteria API.
 
     All above methods will include additional criteria specified by :ref:`Filters <filters>`.
 
+.. note::
+
+    Magic ``findBy`` and ``findOneBy`` calls described below are deprecated in 1.2 and
+    will be removed in 2.0.
+
 Additional methods that are not defined explicitly in the repository class may also be
 used if they follow a specific naming convention:
 

lib/Doctrine/ODM/MongoDB/DocumentRepository.php

@@ -206,9 +206,15 @@ public function findOneBy(array $criteria)
      *                                 or no find* method at all and therefore an invalid
      *                                 method call.
      * @return array|object The found document/documents.
+     *
+     * @deprecated method was deprecated in 1.2 and will be removed in 2.0
      */
     public function __call($method, $arguments)
     {
+        @trigger_error(
+            'Using magic findBy and findOneBy calls was deprecated in version 1.2 and will be removed altogether in 2.0.',
+            E_USER_DEPRECATED
+        );
         if (strpos($method, 'findBy') === 0) {
             $by = substr($method, 6, strlen($method));
             $method = 'findBy';