Updating doc blocks for ModelBehavior so they better reflect the actu…

…al behaviour of the methods.

Removing unused variable assignment.
Fixes #810

cake/libs/model/model_behavior.php

@@ -81,7 +81,7 @@ function cleanup(&$model) {
  *
  * @param object $model Model using this behavior
  * @param array $queryData Data used to execute this query, i.e. conditions, order, etc.
- * @return boolean True if the operation should continue, false if it should abort
+ * @return mixed False if the operation should abort. Any other result will continue.
  * @access public
  */
 	function beforeFind(&$model, $query) { }
@@ -101,7 +101,7 @@ function afterFind(&$model, $results, $primary) { }
  * Before validate callback
  *
  * @param object $model Model using this behavior
- * @return boolean True if validate operation should continue, false to abort
+ * @return mixed False if the operation should abort. Any other result will continue.
  * @access public
  */
 	function beforeValidate(&$model) { }
@@ -110,7 +110,7 @@ function beforeValidate(&$model) { }
  * Before save callback
  *
  * @param object $model Model using this behavior
- * @return boolean True if the operation should continue, false if it should abort
+ * @return mixed False if the operation should abort. Any other result will continue.
  * @access public
  */
 	function beforeSave(&$model) { }
@@ -129,7 +129,7 @@ function afterSave(&$model, $created) { }
  *
  * @param object $model Model using this behavior
  * @param boolean $cascade If true records that depend on this record will also be deleted
- * @return boolean True if the operation should continue, false if it should abort
+ * @return mixed False if the operation should abort. Any other result will continue.
  * @access public
  */
 	function beforeDelete(&$model, $cascade = true) { }
@@ -483,7 +483,6 @@ function trigger(&$model, $callback, $params = array(), $options = array()) {
 		if (empty($this->_attached)) {
 			return true;
 		}
-		$_params = $params;
 		$options = array_merge(array('break' => false, 'breakOn' => array(null, false), 'modParams' => false), $options);
 		$count = count($this->_attached);