You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@geode.apache.org by do...@apache.org on 2022/04/18 16:19:48 UTC

[geode] branch develop updated: GEODE-10023: do not @link to type params (#7601)

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

donalevans pushed a commit to branch develop
in repository https://gitbox.apache.org/repos/asf/geode.git


The following commit(s) were added to refs/heads/develop by this push:
     new f7eb7359a2 GEODE-10023: do not @link to type params (#7601)
f7eb7359a2 is described below

commit f7eb7359a229a75caa1e8c491588d138218a0144
Author: Donal Evans <do...@vmware.com>
AuthorDate: Mon Apr 18 09:19:43 2022 -0700

    GEODE-10023: do not @link to type params (#7601)
    
    Some javadocs contained @link tags pointing to type parameters. These
    should have been @code tags, as type parameters cannot be linked to
    
    Authored-by: Donal Evans <do...@vmware.com>
---
 .../src/main/java/org/apache/geode/services/result/Result.java    | 8 ++++----
 .../main/java/org/apache/geode/services/result/impl/Success.java  | 2 +-
 .../geode/management/api/ClusterManagementOperationResult.java    | 2 +-
 .../geode/management/api/ClusterManagementRealizationResult.java  | 2 +-
 4 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/geode-core/src/main/java/org/apache/geode/services/result/Result.java b/geode-core/src/main/java/org/apache/geode/services/result/Result.java
index 350dc9b0f2..ebdd155803 100644
--- a/geode-core/src/main/java/org/apache/geode/services/result/Result.java
+++ b/geode-core/src/main/java/org/apache/geode/services/result/Result.java
@@ -30,27 +30,27 @@ import org.apache.geode.annotations.Experimental;
 @Experimental
 public interface Result<SuccessType, FailureType> {
   /**
-   * A mapping function that maps to either {@link SuccessType} or {@link FailureType} depending on
+   * A mapping function that maps to either {@code SuccessType} or {@code FailureType} depending on
    * success or
    * failure of the operation.
    *
    * @param successFunction the mapping function to map the SuccessType to the resultant type
    * @param errorFunction the mapping function to map the FailureType to the resultant error type
    * @param <T> the resultant type
-   * @return result of type {@link T}
+   * @return result of type {@code T}
    */
   <T> T map(Function<SuccessType, T> successFunction,
       Function<FailureType, T> errorFunction);
 
   /**
-   * The return message of a successful operation. The return type is of type {@link SuccessType}
+   * The return message of a successful operation. The return type is of type {@code SuccessType}
    *
    * @return the result of the operation
    */
   SuccessType getMessage();
 
   /**
-   * The return message of a failed operation. The return type is of type {@link FailureType}
+   * The return message of a failed operation. The return type is of type {@code FailureType}
    *
    * @return the failure message of why the operation did not succeed.
    */
diff --git a/geode-core/src/main/java/org/apache/geode/services/result/impl/Success.java b/geode-core/src/main/java/org/apache/geode/services/result/impl/Success.java
index 11017392d5..481e98fc42 100644
--- a/geode-core/src/main/java/org/apache/geode/services/result/impl/Success.java
+++ b/geode-core/src/main/java/org/apache/geode/services/result/impl/Success.java
@@ -23,7 +23,7 @@ import org.apache.geode.services.result.ServiceResult;
 
 /**
  * This type of {@link ServiceResult} represents a successful operation. It contains the
- * return value of type {@link SuccessType}
+ * return value of type {@code SuccessType}
  *
  * @param <SuccessType> the result type for a successful operation.
  *
diff --git a/geode-management/src/main/java/org/apache/geode/management/api/ClusterManagementOperationResult.java b/geode-management/src/main/java/org/apache/geode/management/api/ClusterManagementOperationResult.java
index 6637292daa..9a4fe20eb7 100644
--- a/geode-management/src/main/java/org/apache/geode/management/api/ClusterManagementOperationResult.java
+++ b/geode-management/src/main/java/org/apache/geode/management/api/ClusterManagementOperationResult.java
@@ -52,7 +52,7 @@ public class ClusterManagementOperationResult<A extends ClusterManagementOperati
   /**
    * normally called by {@link ClusterManagementService#start(ClusterManagementOperation)}
    *
-   * @param statusCode the {@link StatusCode} of the result
+   * @param statusCode the {@code StatusCode} of the result
    * @param message the status message to set
    * @param operationStart a {@link Date} representing the time the operation started
    * @param operationEnd a {@link Date} representing the time the operation ended
diff --git a/geode-management/src/main/java/org/apache/geode/management/api/ClusterManagementRealizationResult.java b/geode-management/src/main/java/org/apache/geode/management/api/ClusterManagementRealizationResult.java
index 56ab28a0a2..1797085521 100644
--- a/geode-management/src/main/java/org/apache/geode/management/api/ClusterManagementRealizationResult.java
+++ b/geode-management/src/main/java/org/apache/geode/management/api/ClusterManagementRealizationResult.java
@@ -35,7 +35,7 @@ public class ClusterManagementRealizationResult extends ClusterManagementResult
   /**
    * for internal use only
    *
-   * @param statusCode the {@link StatusCode} to set
+   * @param statusCode the {@code StatusCode} to set
    * @param message the status message to set
    */
   public ClusterManagementRealizationResult(StatusCode statusCode, String message) {