add keyword arguments to mocking.return_for_args

This branch0 makes return_for_args able to handle keyword args, adds an explicit declaration that the mocked object is a method, and expands the pydocs. This is an API change to the function and I have updated all the internal users that I could find.

Trac:
Username: robinson