Fixed #690: inconsistant use of `fields` in api docs

Also messed with spacing so that the end of a sentence could be less
easily confused with the dot operator in a particular place.