remove usage of deprecated method, add missing comment

Signed-off-by: Lukas Jungmann <[email protected]>

Author: lukasj

api/src/main/java/jakarta/json/spi/JsonProvider.java

@@ -50,6 +50,9 @@ public abstract class JsonProvider {
     private static final String DEFAULT_PROVIDER
             = "org.eclipse.jsonp.JsonProviderImpl";
 
+    /**
+     * Default constructor.
+     */
     protected JsonProvider() {
     }
 
@@ -70,7 +73,7 @@ public static JsonProvider provider() {
         }
         try {
             Class<?> clazz = Class.forName(DEFAULT_PROVIDER);
-            return (JsonProvider) clazz.newInstance();
+            return (JsonProvider) clazz.getConstructor().newInstance();
         } catch (ClassNotFoundException x) {
             throw new JsonException(
                     "Provider " + DEFAULT_PROVIDER + " not found", x);

api/src/main/java/jakarta/json/stream/JsonParsingException.java

@@ -24,6 +24,9 @@
  */
 public class JsonParsingException extends JsonException {
 
+    /**
+     * The location of the incorrect JSON.
+     */
     private final JsonLocation location;
 
     /**