Improved documentation, made upsert return type void

Specified what the boolean return values for certain functions (like
insert) mean.

Since upsert should always succeed, we can remove the return value from
the signature. Note this is a change to a public function, so it may
slightly break existing code, but not in a significant way.