added a note to the api documentation about JSON_SORT_KEYS. Fixes #922