Merge pull request cakephp#3786 from cakephp/2.x-dependent-limitation

Document a limitation of 'dependent'

en/models/deleting-data.rst

@@ -32,6 +32,12 @@ You can hook custom logic into the delete process using the ``beforeDelete`` and
 ``afterDelete`` callbacks present in both Models and Behaviors. See
 :doc:`/models/callback-methods` for more information.
 
+.. note::
+
+    If you delete a record with dependent records and one of their delete callbacks,
+    e.g. ``beforeDelete`` returns ``false``, it will not stop the further event
+    propagation nor does it change the return value of the initial ``delete``.
+
 .. _model-deleteall:
 
 deleteAll