Fix error in doc and make it more clear

The mentioned parameter was no longer last :)
The default behaviour with regard to mocking concrete methods
is unexpected, at least to me. So I changed the doc to mention
it more explicitly.
Merge pull request #1244 from JeroenDeDauw/fixdoc

Fix error in doc and make it more clear