Fix #1432: add details around expectations.withArgs behavior to docs

sinonjs · Jul 28, 2017 · 8f7bd5d · 8f7bd5d
1 parent cbf1128
commit 8f7bd5d
Showing 1 changed file with 4 additions and 0 deletions.
diff --git a/docs/release-source/release/mocks.md b/docs/release-source/release/mocks.md
@@ -146,11 +146,15 @@ Expect the method to be called exactly `number` times.
 
 Expect the method to be called with the provided arguments and possibly others.
 
+An `expectation` instance only holds onto a single set of arguments specified with `withArgs`. Subsequent calls will overwrite the previously-specified set of arguments (even if they are different), so it is generally not intended that this method be invoked more than once per test case.
+
 
 #### `expectation.withExactArgs(arg1, arg2, ...);`
 
 Expect the method to be called with the provided arguments and no others.
 
+An `expectation` instance only holds onto a single set of arguments specified with `withExactArgs`. Subsequent calls will overwrite the previously-specified set of arguments (even if they are different), so it is generally not intended that this method be invoked more than once per test case.
+
 
 #### `expectation.on(obj);`