improved jdoc

Author: rbri

src/main/java/org/htmlunit/javascript/host/crypto/SubtleCrypto.java

@@ -94,13 +94,17 @@ public class SubtleCrypto extends HtmlUnitScriptable {
     );
 
     /**
+     * The recognized cryptographic key usages.
+     *
      * @see <a href="https://w3c.github.io/webcrypto/#dfn-RecognizedKeyUsage">RecognizedKeyUsage</a>
      */
     private static final Set<String> RECOGNIZED_KEY_USAGES = Collections.unmodifiableSet(
             new LinkedHashSet<>(List.of("encrypt", "decrypt", "sign", "verify",
                     "deriveKey", "deriveBits", "wrapKey", "unwrapKey")));
 
     /**
+     * The valid authentication tag lengths for AES-GCM, in bits.
+     *
      * @see <a href="https://w3c.github.io/webcrypto/#aes-gcm-operations">AES-GCM encrypt, step 6</a>
      */
     private static final Set<Integer> VALID_AES_GCM_TAG_LENGTHS = Set.of(32, 64, 96, 104, 112, 120, 128);

src/main/java/org/htmlunit/javascript/host/css/ComputedFont.java

@@ -55,7 +55,11 @@ static String[] getDetails(final String font) {
     }
 
     /**
-     * @return an array of {@code fontSize} and {@code lineHeight}, or {@code null} if invalid
+     * Parses the specified font-size value into its font size and line height components.
+     *
+     * @param fontSize the font-size value to parse
+     * @return an array containing the font size and line height, or {@code null}
+     *         if the value is invalid
      */
     private static String[] getFontSizeDetails(final String fontSize) {
         final int slash = fontSize.indexOf('/');