DOC fix some docstring/parameter list mismatches 

(particularly in metrics and bayes)
See #2062 for a list and a script to fetch them
@jnothman Is this script supposed to be included along with the fix for #2062?