astropy/astropy — pull request #1196 by hamogu (2014-05-20 23:38:51+00:00)
Title: 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.