fix addAssociations() docs: null arg does nothing

docs/api/associations/belongs-to-many.md

@@ -74,9 +74,9 @@ Associate several instances with this.
 
 
 | Name | Type | Description |
 | Name | Type | Description |
 | ---- | ---- | ----------- |
 | ---- | ---- | ----------- |
-| [newAssociations] | Array.<Instance | String | Number> | An array of instances or primary key of instances to associate with this. Pass `null` or `undefined` to remove all associations. |
-| [options] | Object | Options passed to `through.findAll`, `bulkCreate`, and `update` `destroy`. Can also hold additional attributes for the join table |
-| [options.validate] | Object | Run validation for the join model |
+| [newAssociations] | Array.<Instance | String | Number> | An array of instances or primary key of instances to associate with this. |
+| [options] | Object | Options passed to `through.findAll`, `bulkCreate` and `update`. Can also hold additional attributes for the join table. |
+| [options.validate] | Object | Run validation for the join model. |
 
 
 
 
 ***
 ***
@@ -85,15 +85,15 @@ Associate several instances with this.
 ## `addAssociation([newAssociation], [options])` -> `Promise`
 ## `addAssociation([newAssociation], [options])` -> `Promise`
 [View code](https://github.com/sequelize/sequelize/blob/0de404640d4c71e2d1f1259356650dfb586a248b/lib/associations/belongs-to-many.js#L239)
 [View code](https://github.com/sequelize/sequelize/blob/0de404640d4c71e2d1f1259356650dfb586a248b/lib/associations/belongs-to-many.js#L239)
 
 
-Associate several instances with this.
+Associate one instance with this.
 
 
 **Params:**
 **Params:**
 
 
 | Name | Type | Description |
 | Name | Type | Description |
 | ---- | ---- | ----------- |
 | ---- | ---- | ----------- |
-| [newAssociation] | Instance | String | Number | An array of instances or primary key of instances to associate with this. Pass `null` or `undefined` to remove all associations. |
-| [options] | Object | Options passed to `through.findAll`, `bulkCreate` and `update`. Can also hold additional attributes for the join table |
-| [options.validate] | Object | Run validation for the join model |
+| [newAssociation] | Instance | String | Number | An instance or primary key of instance to associate with this. |
+| [options] | Object | Options passed to `through.findAll`, `bulkCreate` and `update`. Can also hold additional attributes for the join table. |
+| [options.validate] | Object | Run validation for the join model. |
 
 
 
 
 ***
 ***

docs/api/associations/has-many.md

@@ -53,9 +53,9 @@ Associate several instances with this.
 
 
 | Name | Type | Description |
 | Name | Type | Description |
 | ---- | ---- | ----------- |
 | ---- | ---- | ----------- |
-| [newAssociations] | Array.<Instance | String | Number> | An array of instances or primary key of instances to associate with this. Pass `null` or `undefined` to remove all associations. |
+| [newAssociations] | Array.<Instance | String | Number> | An array of instances or primary key of instances to associate with this. |
 | [options] | Object | Options passed to `target.update`. |
 | [options] | Object | Options passed to `target.update`. |
-| [options.validate] | Object | Run validation for the join model |
+| [options.validate] | Object | Run validation for the join model. |
 
 
 
 
 ***
 ***
@@ -64,15 +64,15 @@ Associate several instances with this.
 ## `addAssociation([newAssociation], [options])` -> `Promise`
 ## `addAssociation([newAssociation], [options])` -> `Promise`
 [View code](https://github.com/sequelize/sequelize/blob/0de404640d4c71e2d1f1259356650dfb586a248b/lib/associations/has-many.js#L134)
 [View code](https://github.com/sequelize/sequelize/blob/0de404640d4c71e2d1f1259356650dfb586a248b/lib/associations/has-many.js#L134)
 
 
-Associate several instances with this.
+Associate one instance with this.
 
 
 **Params:**
 **Params:**
 
 
 | Name | Type | Description |
 | Name | Type | Description |
 | ---- | ---- | ----------- |
 | ---- | ---- | ----------- |
-| [newAssociation] | Instance | String | Number | An array of instances or primary key of instances to associate with this. Pass `null` or `undefined` to remove all associations. |
+| [newAssociation] | Instance | String | Number | An instance or primary key of instance to associate with this. |
 | [options] | Object | Options passed to `target.update`. |
 | [options] | Object | Options passed to `target.update`. |
-| [options.validate] | Object | Run validation for the join model |
+| [options.validate] | Object | Run validation for the join model. |
 
 
 
 
 ***
 ***

lib/associations/belongs-to-many.js

@@ -220,19 +220,19 @@ var BelongsToMany = function(source, target, options) {
     /**
     /**
      * Associate several instances with this.
      * Associate several instances with this.
      *
      *
-     * @param {Array<Instance|String|Number>} [newAssociations] An array of instances or primary key of instances to associate with this. Pass `null` or `undefined` to remove all associations.
-     * @param {Object} [options] Options passed to `through.findAll`, `bulkCreate`, and `update` `destroy`. Can also hold additional attributes for the join table
-     * @param {Object} [options.validate] Run validation for the join model
+     * @param {Array<Instance|String|Number>} [newAssociations] An array of instances or primary key of instances to associate with this.
+     * @param {Object} [options] Options passed to `through.findAll`, `bulkCreate` and `update`. Can also hold additional attributes for the join table.
+     * @param {Object} [options.validate] Run validation for the join model.
      * @return {Promise}
      * @return {Promise}
      * @method addAssociations
      * @method addAssociations
      */
      */
     addMultiple: 'add' + plural,
     addMultiple: 'add' + plural,
     /**
     /**
-     * Associate several instances with this.
+     * Associate one instance with this.
      *
      *
-     * @param {Instance|String|Number} [newAssociation] An array of instances or primary key of instances to associate with this. Pass `null` or `undefined` to remove all associations.
-     * @param {Object} [options] Options passed to `through.findAll`, `bulkCreate` and `update`. Can also hold additional attributes for the join table
-     * @param {Object} [options.validate] Run validation for the join model
+     * @param {Instance|String|Number} [newAssociation] An instance or primary key of instance to associate with this.
+     * @param {Object} [options] Options passed to `through.findAll`, `bulkCreate` and `update`. Can also hold additional attributes for the join table.
+     * @param {Object} [options.validate] Run validation for the join model.
      * @return {Promise}
      * @return {Promise}
      * @method addAssociation
      * @method addAssociation
      */
      */

lib/associations/has-many.js

@@ -115,19 +115,19 @@ var HasMany = function(source, target, options) {
     /**
     /**
      * Associate several instances with this.
      * Associate several instances with this.
      *
      *
-     * @param {Array<Instance|String|Number>} [newAssociations] An array of instances or primary key of instances to associate with this. Pass `null` or `undefined` to remove all associations.
+     * @param {Array<Instance|String|Number>} [newAssociations] An array of instances or primary key of instances to associate with this.
      * @param {Object} [options] Options passed to `target.update`.
      * @param {Object} [options] Options passed to `target.update`.
-     * @param {Object} [options.validate] Run validation for the join model
+     * @param {Object} [options.validate] Run validation for the join model.
      * @return {Promise}
      * @return {Promise}
      * @method addAssociations
      * @method addAssociations
      */
      */
     addMultiple: 'add' + plural,
     addMultiple: 'add' + plural,
     /**
     /**
-     * Associate several instances with this.
+     * Associate one instance with this.
      *
      *
-     * @param {Instance|String|Number} [newAssociation] An array of instances or primary key of instances to associate with this. Pass `null` or `undefined` to remove all associations.
+     * @param {Instance|String|Number} [newAssociation] An instance or primary key of instance to associate with this.
      * @param {Object} [options] Options passed to `target.update`.
      * @param {Object} [options] Options passed to `target.update`.
-     * @param {Object} [options.validate] Run validation for the join model
+     * @param {Object} [options.validate] Run validation for the join model.
      * @return {Promise}
      * @return {Promise}
      * @method addAssociation
      * @method addAssociation
      */
      */