Merge branch 'main' of gitlab.cryptoworkshop.com:root/bc-java

Author: dghgit

core/src/main/java/org/bouncycastle/asn1/ASN1BitString.java

@@ -80,6 +80,7 @@ public static ASN1BitString getTagged(ASN1TaggedObject taggedObject, boolean dec
      * 
      * @deprecated Will be removed
      */
+    @Deprecated
     static protected int getPadBits(int bitString)
     {
         int val = 0;
@@ -130,6 +131,7 @@ static protected int getPadBits(int bitString)
      * 
      * @deprecated Will be removed
      */
+    @Deprecated
     static protected byte[] getBytes(int bitString)
     {
         if (bitString == 0)

core/src/main/java/org/bouncycastle/asn1/ASN1InputStream.java

@@ -122,6 +122,7 @@ protected int getLimit()
     /**
      * @deprecated No longer used; will be removed
      */
+    @Deprecated
     protected int readLength()
         throws IOException
     {
@@ -136,6 +137,7 @@ protected int readLength()
     /**
      * @deprecated No longer used; will be removed
      */
+    @Deprecated
     protected void readFully(
         byte[]  bytes)
         throws IOException

core/src/main/java/org/bouncycastle/asn1/DERExternal.java

@@ -50,6 +50,7 @@ public DERExternal(ASN1EncodableVector vector)
      *
      * @deprecated Use {@link #fromSequence(ASN1Sequence)} instead.
      */
+    @Deprecated
     public DERExternal(DERSequence sequence)
     {
         super(sequence);

core/src/main/java/org/bouncycastle/asn1/DLExternal.java

@@ -50,6 +50,7 @@ public DLExternal(ASN1EncodableVector vector)
      *
      * @deprecated Use {@link #fromSequence(ASN1Sequence)} instead.
      */
+    @Deprecated
     public DLExternal(DLSequence sequence)
     {
         super(sequence);

core/src/main/java/org/bouncycastle/asn1/x500/X500Name.java

@@ -51,8 +51,8 @@ public X500Name(X500NameStyle style, X500Name name)
     /**
      * Return a X500Name based on the passed in tagged object.
      * 
-     * @param obj tag object holding name.
-     * @param explicit true if explicitly tagged false otherwise.
+     * @param taggedObject tag object holding name.
+     * @param declaredExplicit true if explicitly tagged false otherwise.
      * @return the X500Name
      */
     public static X500Name getInstance(ASN1TaggedObject taggedObject, boolean declaredExplicit)

core/src/main/java/org/bouncycastle/asn1/x509/X509Extension.java

@@ -160,7 +160,7 @@ public class X509Extension
     public static final ASN1ObjectIdentifier auditIdentity = new ASN1ObjectIdentifier("1.3.6.1.5.5.7.1.4");
 
     /**
-     * <a href="https://davidben.github.io/merkle-tree-certs/draft-ietf-plants-merkle-tree-certs.html>Merkle Tree Certificates</a>
+     * <a href="https://davidben.github.io/merkle-tree-certs/draft-ietf-plants-merkle-tree-certs.html">Merkle Tree Certificates</a>
      * 1.3.6.1.5.5.7.25.TBD
      * */
     public static final ASN1ObjectIdentifier id_rdna_trustAnchorID = new ASN1ObjectIdentifier("1.3.6.1.5.5.7.25");

core/src/main/java/org/bouncycastle/crypto/engines/Salsa20Engine.java

@@ -36,6 +36,7 @@ protected void packTauOrSigma(int keyLength, int[] state, int stateOffset)
     }
 
     /** @deprecated */
+    @Deprecated
     protected final static byte[]
         sigma = Strings.toByteArray("expand 32-byte k"),
         tau   = Strings.toByteArray("expand 16-byte k");

core/src/main/java/org/bouncycastle/crypto/kems/mlkem/package-info.java

@@ -1,7 +1,8 @@
 /**
  * ML-KEM (FIPS 203) bindings of the lightweight KEM API
  * ({@link org.bouncycastle.crypto.EncapsulatedSecretGenerator} /
- * {@link org.bouncycastle.crypto.EncapsulatedSecretExtractor}) sitting on top of the
- * {@link org.bouncycastle.pqc.crypto.mlkem} primitives.
+ * {@link org.bouncycastle.crypto.EncapsulatedSecretExtractor}), backing
+ * {@link org.bouncycastle.crypto.kems.MLKEMGenerator} and
+ * {@link org.bouncycastle.crypto.kems.MLKEMExtractor}.
  */
 package org.bouncycastle.crypto.kems.mlkem;

core/src/main/java/org/bouncycastle/crypto/signers/mldsa/package-info.java

@@ -1,6 +1,5 @@
 /**
- * ML-DSA (FIPS 204) bindings of the lightweight signer API. Wraps the primitives in
- * {@link org.bouncycastle.pqc.crypto.mldsa} as {@link org.bouncycastle.crypto.Signer} /
- * {@link org.bouncycastle.crypto.StatefulSigner} implementations.
+ * Internal ML-DSA (FIPS 204) engine backing {@link org.bouncycastle.crypto.signers.MLDSASigner}
+ * and {@link org.bouncycastle.crypto.signers.HashMLDSASigner}.
  */
 package org.bouncycastle.crypto.signers.mldsa;

core/src/main/java/org/bouncycastle/crypto/signers/slhdsa/package-info.java

@@ -1,6 +1,5 @@
 /**
- * SLH-DSA (FIPS 205) bindings of the lightweight signer API. Wraps the primitives in
- * {@link org.bouncycastle.pqc.crypto.slhdsa} as {@link org.bouncycastle.crypto.Signer}
- * implementations.
+ * Internal SLH-DSA (FIPS 205) engine backing {@link org.bouncycastle.crypto.signers.SLHDSASigner}
+ * and {@link org.bouncycastle.crypto.signers.HashSLHDSASigner}.
  */
 package org.bouncycastle.crypto.signers.slhdsa;