document new onCall stub API

add section to the top of the stub section explaining differences and
breaking changes in sinon versions 1.5 to 1.8.