Fix JavaDoc warnings (#3990)

src/main/java/redis/clients/jedis/CommandObjects.java

@@ -2006,7 +2006,7 @@ public final CommandObject<List<Tuple>> zdiffWithScores(byte[]... keys) {
  }
 
  /**
- * @deprecated Use {@link #zdiffstore(byte..., byte[]...)}.
+ * @deprecated Use {@link #zdiffstore(byte[], byte[][])}.
  */
  @Deprecated
  public final CommandObject<Long> zdiffStore(byte[] dstkey, byte[]... keys) {

src/main/java/redis/clients/jedis/DefaultJedisClientConfig.java

@@ -175,7 +175,8 @@ public DefaultJedisClientConfig build() {
  }
 
  /**
- * Shortcut to {@link Builder#protocol(redis.clients.jedis.RedisProtocol)} with {@link RedisProtocol#RESP3}.
+ * Shortcut to {@link redis.clients.jedis.DefaultJedisClientConfig.Builder#protocol(RedisProtocol)} with
+ * {@link RedisProtocol#RESP3}.
  */
  public Builder resp3() {
  return protocol(RedisProtocol.RESP3);

src/main/java/redis/clients/jedis/JedisCluster.java

@@ -30,17 +30,21 @@ public class JedisCluster extends UnifiedJedis {
  public static final int DEFAULT_MAX_ATTEMPTS = 5;
 
  /**
- * Creates a JedisCluster instance. The provided node is used to make the first contact with the cluster.<br>
- * Here, the default timeout of {@value JedisCluster#DEFAULT_TIMEOUT} ms is being used with {@value JedisCluster#DEFAULT_MAX_ATTEMPTS} maximum attempts.
+ * Creates a JedisCluster instance. The provided node is used to make the first contact with the cluster.
+ * <p>
+ * Here, the default timeout of {@value redis.clients.jedis.JedisCluster#DEFAULT_TIMEOUT} ms is being used with
+ * {@value redis.clients.jedis.JedisCluster#DEFAULT_MAX_ATTEMPTS} maximum attempts.
  * @param node Node to first connect to.
  */
  public JedisCluster(HostAndPort node) {
  this(Collections.singleton(node));
  }
 
  /**
- * Creates a JedisCluster instance. The provided node is used to make the first contact with the cluster.<br>
- * Here, the default timeout of {@value JedisCluster#DEFAULT_TIMEOUT} ms is being used with {@value JedisCluster#DEFAULT_MAX_ATTEMPTS} maximum attempts.
+ * Creates a JedisCluster instance. The provided node is used to make the first contact with the cluster.
+ * <p>
+ * Here, the default timeout of {@value redis.clients.jedis.JedisCluster#DEFAULT_TIMEOUT} ms is being used with
+ * {@value redis.clients.jedis.JedisCluster#DEFAULT_MAX_ATTEMPTS} maximum attempts.
  * @param node Node to first connect to.
  * @param timeout connection and socket timeout in milliseconds.
  */
@@ -117,7 +121,9 @@ public JedisCluster(HostAndPort node, final JedisClientConfig clientConfig, int
 
  /**
  * Creates a JedisCluster with multiple entry points.
- * Here, the default timeout of {@value JedisCluster#DEFAULT_TIMEOUT} ms is being used with {@value JedisCluster#DEFAULT_MAX_ATTEMPTS} maximum attempts.
+ * <p>
+ * Here, the default timeout of {@value redis.clients.jedis.JedisCluster#DEFAULT_TIMEOUT} ms is being used with
+ * {@value redis.clients.jedis.JedisCluster#DEFAULT_MAX_ATTEMPTS} maximum attempts.
  * @param nodes Nodes to connect to.
  */
  public JedisCluster(Set<HostAndPort> nodes) {
@@ -126,7 +132,9 @@ public JedisCluster(Set<HostAndPort> nodes) {
 
  /**
  * Creates a JedisCluster with multiple entry points.
- * Here, the default timeout of {@value JedisCluster#DEFAULT_TIMEOUT} ms is being used with {@value JedisCluster#DEFAULT_MAX_ATTEMPTS} maximum attempts.
+ * <p>
+ * Here, the default timeout of {@value redis.clients.jedis.JedisCluster#DEFAULT_TIMEOUT} ms is being used with
+ * {@value redis.clients.jedis.JedisCluster#DEFAULT_MAX_ATTEMPTS} maximum attempts.
  * @param nodes Nodes to connect to.
  * @param timeout connection and socket timeout in milliseconds.
  */

src/main/java/redis/clients/jedis/commands/FunctionBinaryCommands.java

@@ -14,7 +14,7 @@ public interface FunctionBinaryCommands {
  * @param name
  * @param keys
  * @param args
- * @return 
+ * @return value depends on the function that was executed
  */
  Object fcall(byte[] name, List<byte[]> keys, List<byte[]> args);
 

src/main/java/redis/clients/jedis/commands/SortedSetBinaryCommands.java

@@ -2,7 +2,6 @@
 
 import java.util.List;
 import java.util.Map;
-import java.util.Set;
 
 import redis.clients.jedis.args.SortedSetOption;
 import redis.clients.jedis.params.*;
@@ -139,7 +138,7 @@ default ScanResult<Tuple> zscan(byte[] key, byte[] cursor) {
  List<Tuple> zdiffWithScores(byte[]... keys);
 
  /**
- * @deprecated Use {@link #zdiffstore(byte..., byte[]...)}.
+ * @deprecated Use {@link #zdiffstore(byte[], byte[][])}.
  */
  @Deprecated
  long zdiffStore(byte[] dstkey, byte[]... keys);
@@ -155,24 +154,24 @@ default ScanResult<Tuple> zscan(byte[] key, byte[] cursor) {
  long zinterstore(byte[] dstkey, ZParams params, byte[]... sets);
 
  /**
- * Similar to {@link SortedSetBinaryCommands#zinter(ZParams, byte[]...) ZINTER}, but
- * instead of returning the result set, it returns just the cardinality of the result.
+ * Similar to {@link #zinter(ZParams, byte[][]) ZINTER}, but instead of returning the result set,
+ * it returns just the cardinality of the result.
  * <p>
  * Time complexity O(N*K) worst case with N being the smallest input sorted set, K
  * being the number of input sorted sets
- * @see SortedSetBinaryCommands#zinter(ZParams, byte[]...)
+ * @see #zinter(ZParams, byte[][])
  * @param keys group of sets
  * @return The number of elements in the resulting intersection
  */
  long zintercard(byte[]... keys);
 
  /**
- * Similar to {@link SortedSetBinaryCommands#zinter(ZParams, byte[]...) ZINTER}, but
- * instead of returning the result set, it returns just the cardinality of the result.
+ * Similar to {@link #zinter(ZParams, byte[][]) ZINTER}, but instead of returning the result set,
+ * it returns just the cardinality of the result.
  * <p>
  * Time complexity O(N*K) worst case with N being the smallest input sorted set, K
  * being the number of input sorted sets
- * @see SortedSetBinaryCommands#zinter(ZParams, byte[]...)
+ * @see #zinter(ZParams, byte[][])
  * @param limit If the intersection cardinality reaches limit partway through the computation,
  * the algorithm will exit and yield limit as the cardinality
  * @param keys group of sets

src/main/java/redis/clients/jedis/commands/SortedSetPipelineBinaryCommands.java

@@ -2,7 +2,6 @@
 
 import java.util.List;
 import java.util.Map;
-import java.util.Set;
 
 import redis.clients.jedis.Response;
 import redis.clients.jedis.args.SortedSetOption;
@@ -140,7 +139,7 @@ default Response<ScanResult<Tuple>> zscan(byte[] key, byte[] cursor) {
  Response<List<Tuple>> zdiffWithScores(byte[]... keys);
 
  /**
- * @deprecated Use {@link #zdiffstore(byte..., byte[]...)}.
+ * @deprecated Use {@link #zdiffstore(byte[], byte[][])}.
  */
  @Deprecated
  Response<Long> zdiffStore(byte[] dstkey, byte[]... keys);