doc: minor javadoc updates

Author: dmaccormack

module/jsonurl-core/src/main/java/org/jsonurl/util/PercentCodec.java

@@ -51,9 +51,7 @@ private PercentCodec() {
     }
 
     /**
-     * Get the next codepoint, percent decoding if necessary. This will
-     * validate the literal character (not the decoded character) as
-     * {@code valid[CHAR] & mask}.
+     * Get the next codepoint, percent decoding if necessary.
      * @param text a valid CharIterator 
      * @return a UNICODE codepoint
      */
@@ -62,10 +60,10 @@ public static int decode(CharIterator text) throws IOException {
     }
 
     /**
-     * Get the next codepoint, percent decoding if necessary. This will
-     * validate the literal character (not the decoded character) as
-     * {@code valid[CHAR] & mask}.
+     * Get the next codepoint, percent decoding if necessary.
      * @param text a valid CharIterator 
+     * @param decodePlus if true, decode {@code +} as though it
+     *     was {@code %20}
      * @return a UNICODE codepoint
      */
     @SuppressWarnings({

module/jsonurl-core/src/main/javadoc/overview.html

@@ -29,8 +29,8 @@ <h2>The Streaming API</h2>
     <h2><a id="security" href="#security">Security</a></h2>
     <p>The parser is designed to parse untrusted input. It supports limits on
     the number of parsed values and depth of nested arrays or objects. When the
-    limit is exceeded a LimitException is thrown. Sane limit values are set by
-    default.
+    limit is exceeded a LimitException is thrown. Reasonable limit values are
+    set by default.
 
 </body>
 </html>

src/main/javadoc/overview.html

@@ -28,7 +28,7 @@ <h2><a id="security" href="#security">Artifacts and Packages</a></h2>
 
       <dt>jsonurl-factory</dt>
       <dd>Provides the <a href="org/jsonurl/factory/package-summary.html">org.jsonurl.factory</a> package</dd>
-      <dd>Provides the <a href="org/jsonurl/factory/j2se/package-summary.html">org.jsonurl.j2se</a> package</dd>
+      <dd>Provides the <a href="org/jsonurl/j2se/package-summary.html">org.jsonurl.j2se</a> package</dd>
 
       <dt>jsonurl-jsonorg</dt>
       <dd>Provides the <a href="org/jsonurl/jsonorg/package-summary.html">org.jsonurl.jsonorg</a> package</dd>