Revert function return type for ABI consistency

We want to keep psmove_get_temperature_in_celsius() compatible to
previous versions, so the function return value is changed back from
int to the original float.
Fix typo in documentation and comments