Clarify Javadoc for skipLimit with custom SkipPolicy

Resolves #4963

Signed-off-by: Subin Kim <rla0010101@gmail.com>
(cherry picked from commit 82bd3a2)

Author: rla124

spring-batch-core/src/main/java/org/springframework/batch/core/step/builder/FaultTolerantStepBuilder.java

@@ -305,10 +305,17 @@ public FaultTolerantStepBuilder<I, O> retryContextCache(RetryContextCache retryC
 	}
 
 	/**
-	 * Sets the maximum number of failed items to skip before the step fails. Ignored if
-	 * an explicit {@link #skipPolicy(SkipPolicy)} is provided.
-	 * @param skipLimit the skip limit to set. Default is 10.
-	 * @return this for fluent chaining
+	 * Sets the maximum number of failed items to skip before the step fails. The default
+	 * value is 10.
+	 * <p>
+	 * This limit is enforced using the default
+	 * {@link org.springframework.batch.core.step.skip.LimitCheckingItemSkipPolicy}. If a
+	 * custom {@link SkipPolicy} is provided via {@link #skipPolicy(SkipPolicy)}, this
+	 * limit will not be enforced by the step directly, but it can be implemented to be
+	 * honored by the custom policy.
+	 * @param skipLimit the maximum number of failed items to skip.
+	 * @return this for fluent chaining.
+	 * @see SkipPolicy
 	 */
 	public FaultTolerantStepBuilder<I, O> skipLimit(int skipLimit) {
 		this.skipLimit = skipLimit;
@@ -341,6 +348,9 @@ public FaultTolerantStepBuilder<I, O> skip(Class<? extends Throwable> type) {
 	/**
 	 * Provide an explicit policy for managing skips. A skip policy determines which
 	 * exceptions are skippable and how many times.
+	 * <p>
+	 * Note that setting a custom policy overrides the default limit-checking behavior
+	 * configured via {@link #skipLimit(int)}.
 	 * @param skipPolicy the skip policy
 	 * @return this for fluent chaining
 	 */