fix some long standing code/doc check issues

partial args matching, old doc style