Check that parameters in the docstring match parameters in the calling signature

If the number and/or name of the parameters in the docstring differs from the number and/or name of parameters in the definition of a function or method that indicates that something is wrong.
(An example for such a problem was seen in #1187).

We should have an algorithm that checks if the docstring mentions all parameters and if the name of the parameters in the docstring and in the function/method signature match.