Cleanup comments

This does mainly two things:
- add missing parameters in methods comments.
- make the "integer" type comment more uniform (it shows up as "int" in some places).

This will show useful for a static analyzer of mine that can generate documentation from the code directly. @johnmccutchan @PeterJensen Can you please look at it quickly? This kind of patches tends to bit-rot very fast!