Polishing.

Refine Javadoc.

See #4203
Original pull request: #4024

Author: mp911de

spring-data-jpa/src/main/java/org/springframework/data/jpa/domain/DeleteSpecification.java

@@ -51,13 +51,11 @@ public interface DeleteSpecification<T> extends Serializable {
 	/**
 	 * Simple static factory method to create a specification which does not participate in matching. The specification
 	 * returned is {@code null}-like, and is elided in all operations.
-	 * 
-	 * <pre>
-	 * {@code
+	 *
+	 * <pre class="code">
 	 * unrestricted().and(other) // consider only `other`
 	 * unrestricted().or(other) // consider only `other`
 	 * not(unrestricted()) // equivalent to `unrestricted()`
-	 * }
 	 * </pre>
 	 *
 	 * @param <T> the type of the {@link Root} the resulting {@literal DeleteSpecification} operates on.
@@ -177,7 +175,7 @@ static <T> DeleteSpecification<T> not(DeleteSpecification<T> spec) {
 
 	/**
 	 * Applies an AND operation to all the given {@link DeleteSpecification}s. If {@code specifications} is empty, the
-	 * resulting {@link DeleteSpecification} will be unrestricted applying to all objects.
+	 * resulting {@link DeleteSpecification} will be {@link #unrestricted()} applying to all objects.
 	 *
 	 * @param specifications the {@link DeleteSpecification}s to compose.
 	 * @return the conjunction of the specifications.
@@ -191,7 +189,7 @@ static <T> DeleteSpecification<T> allOf(DeleteSpecification<T>... specifications
 
 	/**
 	 * Applies an AND operation to all the given {@link DeleteSpecification}s. If {@code specifications} is empty, the
-	 * resulting {@link DeleteSpecification} will be unrestricted applying to all objects.
+	 * resulting {@link DeleteSpecification} will be {@link #unrestricted()} applying to all objects.
 	 *
 	 * @param specifications the {@link DeleteSpecification}s to compose.
 	 * @return the conjunction of the specifications.
@@ -206,7 +204,7 @@ static <T> DeleteSpecification<T> allOf(Iterable<DeleteSpecification<T>> specifi
 
 	/**
 	 * Applies an OR operation to all the given {@link DeleteSpecification}s. If {@code specifications} is empty, the
-	 * resulting {@link DeleteSpecification} will be unrestricted applying to all objects.
+	 * resulting {@link DeleteSpecification} will be {@link #unrestricted()} applying to all objects.
 	 *
 	 * @param specifications the {@link DeleteSpecification}s to compose.
 	 * @return the disjunction of the specifications.
@@ -220,7 +218,7 @@ static <T> DeleteSpecification<T> anyOf(DeleteSpecification<T>... specifications
 
 	/**
 	 * Applies an OR operation to all the given {@link DeleteSpecification}s. If {@code specifications} is empty, the
-	 * resulting {@link DeleteSpecification} will be unrestricted applying to all objects.
+	 * resulting {@link DeleteSpecification} will be {@link #unrestricted()} applying to all objects.
 	 *
 	 * @param specifications the {@link DeleteSpecification}s to compose.
 	 * @return the disjunction of the specifications.

spring-data-jpa/src/main/java/org/springframework/data/jpa/domain/PredicateSpecification.java

@@ -50,13 +50,11 @@ public interface PredicateSpecification<T> extends Serializable {
 	/**
 	 * Simple static factory method to create a specification which does not participate in matching. The specification
 	 * returned is {@code null}-like, and is elided in all operations.
-	 * 
-	 * <pre>
-	 * {@code
+	 *
+	 * <pre class="code">
 	 * unrestricted().and(other) // consider only `other`
 	 * unrestricted().or(other) // consider only `other`
 	 * not(unrestricted()) // equivalent to `unrestricted()`
-	 * }
 	 * </pre>
 	 *
 	 * @param <T> the type of the {@link Root} the resulting {@literal PredicateSpecification} operates on.
@@ -131,7 +129,7 @@ static <T> PredicateSpecification<T> not(PredicateSpecification<T> spec) {
 
 	/**
 	 * Applies an AND operation to all the given {@link PredicateSpecification}s. If {@code specifications} is empty, the
-	 * resulting {@link PredicateSpecification} will be unrestricted applying to all objects.
+	 * resulting {@link PredicateSpecification} will be {@link #unrestricted()} applying to all objects.
 	 *
 	 * @param specifications the {@link PredicateSpecification}s to compose.
 	 * @return the conjunction of the specifications.
@@ -145,7 +143,7 @@ static <T> PredicateSpecification<T> allOf(PredicateSpecification<T>... specific
 
 	/**
 	 * Applies an AND operation to all the given {@link PredicateSpecification}s. If {@code specifications} is empty, the
-	 * resulting {@link PredicateSpecification} will be unrestricted applying to all objects.
+	 * resulting {@link PredicateSpecification} will be {@link #unrestricted()} applying to all objects.
 	 *
 	 * @param specifications the {@link PredicateSpecification}s to compose.
 	 * @return the conjunction of the specifications.
@@ -160,7 +158,7 @@ static <T> PredicateSpecification<T> allOf(Iterable<PredicateSpecification<T>> s
 
 	/**
 	 * Applies an OR operation to all the given {@link PredicateSpecification}s. If {@code specifications} is empty, the
-	 * resulting {@link PredicateSpecification} will be unrestricted applying to all objects.
+	 * resulting {@link PredicateSpecification} will be {@link #unrestricted()} applying to all objects.
 	 *
 	 * @param specifications the {@link PredicateSpecification}s to compose.
 	 * @return the disjunction of the specifications.
@@ -174,7 +172,7 @@ static <T> PredicateSpecification<T> anyOf(PredicateSpecification<T>... specific
 
 	/**
 	 * Applies an OR operation to all the given {@link PredicateSpecification}s. If {@code specifications} is empty, the
-	 * resulting {@link PredicateSpecification} will be unrestricted applying to all objects.
+	 * resulting {@link PredicateSpecification} will be {@link #unrestricted()} applying to all objects.
 	 *
 	 * @param specifications the {@link PredicateSpecification}s to compose.
 	 * @return the disjunction of the specifications.

spring-data-jpa/src/main/java/org/springframework/data/jpa/domain/Specification.java

@@ -58,13 +58,11 @@ public interface Specification<T> extends Serializable {
 	/**
 	 * Simple static factory method to create a specification which does not participate in matching. The specification
 	 * returned is {@code null}-like, and is elided in all operations.
-	 * 
-	 * <pre>
-	 * {@code
+	 *
+	 * <pre class="code">
 	 * unrestricted().and(other) // consider only `other`
 	 * unrestricted().or(other) // consider only `other`
 	 * not(unrestricted()) // equivalent to `unrestricted()`
-	 * }
 	 * </pre>
 	 *
 	 * @param <T> the type of the {@link Root} the resulting {@literal Specification} operates on.
@@ -192,7 +190,7 @@ static <T> Specification<T> not(Specification<T> spec) {
 
 	/**
 	 * Applies an AND operation to all the given {@link Specification}s. If {@code specifications} is empty, the resulting
-	 * {@link Specification} will be unrestricted applying to all objects.
+	 * {@link Specification} will be {@link #unrestricted()} applying to all objects.
 	 *
 	 * @param specifications the {@link Specification}s to compose.
 	 * @return the conjunction of the specifications.
@@ -207,7 +205,7 @@ static <T> Specification<T> allOf(Specification<T>... specifications) {
 
 	/**
 	 * Applies an AND operation to all the given {@link Specification}s. If {@code specifications} is empty, the resulting
-	 * {@link Specification} will be unrestricted applying to all objects.
+	 * {@link Specification} will be {@link #unrestricted()} applying to all objects.
 	 *
 	 * @param specifications the {@link Specification}s to compose.
 	 * @return the conjunction of the specifications.
@@ -223,7 +221,7 @@ static <T> Specification<T> allOf(Iterable<Specification<T>> specifications) {
 
 	/**
 	 * Applies an OR operation to all the given {@link Specification}s. If {@code specifications} is empty, the resulting
-	 * {@link Specification} will be unrestricted applying to all objects.
+	 * {@link Specification} will be {@link #unrestricted()} applying to all objects.
 	 *
 	 * @param specifications the {@link Specification}s to compose.
 	 * @return the disjunction of the specifications
@@ -238,7 +236,7 @@ static <T> Specification<T> anyOf(Specification<T>... specifications) {
 
 	/**
 	 * Applies an OR operation to all the given {@link Specification}s. If {@code specifications} is empty, the resulting
-	 * {@link Specification} will be unrestricted applying to all objects.
+	 * {@link Specification} will be {@link #unrestricted()} applying to all objects.
 	 *
 	 * @param specifications the {@link Specification}s to compose.
 	 * @return the disjunction of the specifications

spring-data-jpa/src/main/java/org/springframework/data/jpa/domain/SpecificationComposition.java

@@ -34,8 +34,8 @@
  * @author Oliver Gierke
  * @author Jens Schauder
  * @author Mark Paluch
- * @see Specification
  * @since 2.2
+ * @see Specification
  */
 class SpecificationComposition {
 

spring-data-jpa/src/main/java/org/springframework/data/jpa/domain/UpdateSpecification.java

@@ -51,13 +51,11 @@ public interface UpdateSpecification<T> extends Serializable {
 	/**
 	 * Simple static factory method to create a specification which does not participate in matching. The specification
 	 * returned is {@code null}-like, and is elided in all operations.
-	 * 
-	 * <pre>
-	 * {@code
+	 *
+	 * <pre class="code">
 	 * unrestricted().and(other) // consider only `other`
 	 * unrestricted().or(other) // consider only `other`
 	 * not(unrestricted()) // equivalent to `unrestricted()`
-	 * }
 	 * </pre>
 	 *
 	 * @param <T> the type of the {@link Root} the resulting {@literal UpdateSpecification} operates on.
@@ -198,7 +196,7 @@ static <T> UpdateSpecification<T> not(UpdateSpecification<T> spec) {
 
 	/**
 	 * Applies an AND operation to all the given {@link UpdateSpecification}s. If {@code specifications} is empty, the
-	 * resulting {@link UpdateSpecification} will be unrestricted applying to all objects.
+	 * resulting {@link UpdateSpecification} will be {@link #unrestricted()} applying to all objects.
 	 *
 	 * @param specifications the {@link UpdateSpecification}s to compose.
 	 * @return the conjunction of the specifications.
@@ -212,7 +210,7 @@ static <T> UpdateSpecification<T> allOf(UpdateSpecification<T>... specifications
 
 	/**
 	 * Applies an AND operation to all the given {@link UpdateSpecification}s. If {@code specifications} is empty, the
-	 * resulting {@link UpdateSpecification} will be unrestricted applying to all objects.
+	 * resulting {@link UpdateSpecification} will be {@link #unrestricted()} applying to all objects.
 	 *
 	 * @param specifications the {@link UpdateSpecification}s to compose.
 	 * @return the conjunction of the specifications.
@@ -227,7 +225,7 @@ static <T> UpdateSpecification<T> allOf(Iterable<UpdateSpecification<T>> specifi
 
 	/**
 	 * Applies an OR operation to all the given {@link UpdateSpecification}s. If {@code specifications} is empty, the
-	 * resulting {@link UpdateSpecification} will be unrestricted applying to all objects.
+	 * resulting {@link UpdateSpecification} will be {@link #unrestricted()} applying to all objects.
 	 *
 	 * @param specifications the {@link UpdateSpecification}s to compose.
 	 * @return the disjunction of the specifications.
@@ -241,7 +239,7 @@ static <T> UpdateSpecification<T> anyOf(UpdateSpecification<T>... specifications
 
 	/**
 	 * Applies an OR operation to all the given {@link UpdateSpecification}s. If {@code specifications} is empty, the
-	 * resulting {@link UpdateSpecification} will be unrestricted applying to all objects.
+	 * resulting {@link UpdateSpecification} will be {@link #unrestricted()} applying to all objects.
 	 *
 	 * @param specifications the {@link UpdateSpecification}s to compose.
 	 * @return the disjunction of the specifications.