Merge pull request #1645 from ShinKenDo/patch-1

Improved wording of Model::invalidFields()

lib/Cake/Model/Model.php

@@ -3142,10 +3142,13 @@ public function validates($options = array()) {
 	}
 
 /**
- * Returns an array of fields that have failed validation. On the current model.
+ * Returns an array of fields that have failed the validation of the current model.
+ * 
+ * Additionally it populates the validationErrors property of the model with the same array.
  *
  * @param string $options An optional array of custom options to be made available in the beforeValidate callback
- * @return array Array of invalid fields
+ * @return array Array of invalid fields and its error messages
+ * 
  * @see Model::validates()
  */
 	public function invalidFields($options = array()) {