[ci skip] Mention that model.destroy returns affected rows. Closes #3822

lib/model.js

@@ -1448,7 +1448,7 @@ module.exports = (function() {
    * @param  {Boolean}      [options.cascade=false]         Only used in conjuction with TRUNCATE. Truncates  all tables that have foreign-key references to the named table, or to any tables added to the group due to CASCADE.
    * @param  {Boolean}      [options.cascade=false]         Only used in conjuction with TRUNCATE. Truncates  all tables that have foreign-key references to the named table, or to any tables added to the group due to CASCADE.
    * @param  {Transaction}  [options.transaction]
    * @param  {Transaction}  [options.transaction]
    * @param  {Function}     [options.logging=false]         A function that gets executed while running the query to log the sql.
    * @param  {Function}     [options.logging=false]         A function that gets executed while running the query to log the sql.
-   * @return {Promise<undefined>}
+   * @return {Promise<Integer>} The number of destroyed rows
    */
    */
   Model.prototype.destroy = function(options) {
   Model.prototype.destroy = function(options) {
     var self = this
     var self = this