Improved validationFailed hook documentation, updated generated api docs

lib/hooks.js

@@ -227,7 +227,8 @@ Hooks.hasHooks = Hooks.hasHook;
 /**
 /**
  * A hook that is run when validation fails
  * A hook that is run when validation fails
  * @param {String}   name
  * @param {String}   name
- * @param {Function} fn   A callback function that is called with instance, options, error
+ * @param {Function} fn   A callback function that is called with instance, options, error. Error is the
+ * SequelizeValidationError. If the callback throws an error, it will replace the original validation error.
  * @name validationFailed
  * @name validationFailed
  */
  */