Improve argument indexing. (#25)
Rename Doxygen directive @return to @returns.

This reads nicer in the source and is now consistent with @throws.