Improve javadoc of JSON.parse() and JSONParseException.

Updated version of my earlier pull request. Should be fairly complete about JSON.parse() now.