Text improvements

These commits are some general editing: improving and cleaning up some of the descriptions about data types and common arguments/returns. I think some things are is a bit more clear now and some possible confusion is avoided.

These edits change nothing in the existing API and add nothing new, they just improve the text.