(commons-crypto) branch master updated: Synchronise comments for easier comparisons

[sebb]

This is an automated email from the ASF dual-hosted git repository.

sebb pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/commons-crypto.git


The following commit(s) were added to refs/heads/master by this push:
     new e64a840f Synchronise comments for easier comparisons
e64a840f is described below

commit e64a840f1c74b6d06f9e06092b5f726e40974ae9
Author: Sebb <s...@apache.org>
AuthorDate: Tue Nov 21 20:20:09 2023 +0000

    Synchronise comments for easier comparisons
    
    [skip ci]
---
 .../commons/crypto/jna/LibreSsl20XNativeJna.java   | 36 +++++++++++-----------
 1 file changed, 18 insertions(+), 18 deletions(-)

diff --git 
a/src/main/java/org/apache/commons/crypto/jna/LibreSsl20XNativeJna.java 
b/src/main/java/org/apache/commons/crypto/jna/LibreSsl20XNativeJna.java
index e849e1f7..74aa6f7f 100644
--- a/src/main/java/org/apache/commons/crypto/jna/LibreSsl20XNativeJna.java
+++ b/src/main/java/org/apache/commons/crypto/jna/LibreSsl20XNativeJna.java
@@ -52,10 +52,10 @@ final class LibreSsl20XNativeJna implements 
OpenSslInterfaceNativeJna {
     // Try to keep methods aligned across versions
 
     /**
-     * Gets engine by id.
+     * Gets engine by id
      *
      * @param id
-     *            engine id.
+     *            engine id
      * @return engine instance
      */
     public static native PointerByReference ENGINE_by_id(String id);
@@ -99,9 +99,9 @@ final class LibreSsl20XNativeJna implements 
OpenSslInterfaceNativeJna {
      * Sets the engine as the default for random number generation.
      *
      * @param e
-     *            engine reference.
+     *            engine reference
      * @param flags
-     *            ENGINE_METHOD_RAND.
+     *            ENGINE_METHOD_RAND
      * @return zero if failed.
      */
     public static native int ENGINE_set_default(PointerByReference e, int 
flags);
@@ -109,7 +109,7 @@ final class LibreSsl20XNativeJna implements 
OpenSslInterfaceNativeJna {
     /**
      * Generates a human-readable string representing the error code e.
      *
-     * @see <a 
href="https://www.openssl.org/docs/man1.0.2/man3/ERR_error_string.html";>ERR_error_string</a>
+     * @see <a 
href="https://www.openssl.org/docs/man1.1.0/man3/ERR_error_string.html";>ERR_error_string</a>
      *
      * @param err
      *            the error code
@@ -131,32 +131,32 @@ final class LibreSsl20XNativeJna implements 
OpenSslInterfaceNativeJna {
     public static native NativeLong ERR_peek_error();
 
     /**
-     * @return an OpenSSL AES EVP cipher instance with a 128-bit key CBC mode.
+     * @return an OpenSSL AES EVP cipher instance with a 128-bit key CBC mode
      */
     public static native PointerByReference EVP_aes_128_cbc();
 
     /**
-     * @return an OpenSSL AES EVP cipher instance with a 128-bit key CTR mode.
+     * @return an OpenSSL AES EVP cipher instance with a 128-bit key CTR mode
      */
     public static native PointerByReference EVP_aes_128_ctr();
 
     /**
-     * @return an OpenSSL AES EVP cipher instance with a 192-bit key CBC mode.
+     * @return an OpenSSL AES EVP cipher instance with a 192-bit key CBC mode
      */
     public static native PointerByReference EVP_aes_192_cbc();
 
     /**
-     * @return an OpenSSL AES EVP cipher instance with a 192-bit key CTR mode.
+     * @return an OpenSSL AES EVP cipher instance with a 192-bit key CTR mode
      */
     public static native PointerByReference EVP_aes_192_ctr();
 
     /**
-     * @return an OpenSSL AES EVP cipher instance with a 256-bit key CBC mode.
+     * @return an OpenSSL AES EVP cipher instance with a 256-bit key CBC mode
      */
     public static native PointerByReference EVP_aes_256_cbc();
 
     /**
-     * @return an OpenSSL AES EVP cipher instance with a 256-bit key CTR mode.
+     * @return an OpenSSL AES EVP cipher instance with a 256-bit key CTR mode
      */
     public static native PointerByReference EVP_aes_256_ctr();
 
@@ -195,12 +195,12 @@ final class LibreSsl20XNativeJna implements 
OpenSslInterfaceNativeJna {
     public static native PointerByReference EVP_CIPHER_CTX_new();
 
     /**
-     * Enables or disables padding.
+     * Enables or disables padding
      *
      * @param c
-     *            cipher context.
+     *            cipher context
      * @param pad
-     *            If the pad parameter is zero then no padding is performed.
+     *            If the pad parameter is zero then no padding is performed
      * @return always returns 1
      */
     public static native int EVP_CIPHER_CTX_set_padding(PointerByReference c, 
int pad);
@@ -260,21 +260,21 @@ final class LibreSsl20XNativeJna implements 
OpenSslInterfaceNativeJna {
             ByteBuffer in, int inl);
 
     /**
-     * Generates random data.
+     * Generates random data
      *
      * @param buf
      *            the bytes for generated random.
      * @param num
-     *            buffer length.
+     *            buffer length
      * @return 1 on success, 0 otherwise.
      */
     public static native int RAND_bytes(ByteBuffer buf, int num);
 
     // Random generator
     /**
-     * OpenSSL uses for random number generation.
+     * OpenSSL uses for random number generation
      *
-     * @return pointers to the respective methods.
+     * @return pointers to the respective methods
      */
     public static native PointerByReference RAND_get_rand_method();