Polishing.

Fix javadoc links.

See gh-125.

spring-vault-core/src/main/java/org/springframework/vault/core/env/LeaseAwareVaultPropertySource.java

@@ -208,7 +208,7 @@ public class LeaseAwareVaultPropertySource
 	 * map.
 	 *
 	 * @param data the map
-	 * @return
+	 * @return the flattened map.
 	 */
 	protected Map<String, String> toStringMap(Map<String, Object> data) {
 		return JsonMapFlattener.flatten(data);

spring-vault-core/src/main/java/org/springframework/vault/core/env/VaultPropertySource.java

@@ -184,7 +184,7 @@ public class VaultPropertySource extends EnumerablePropertySource<VaultOperation
 	 * map.
 	 *
 	 * @param data the map
-	 * @return
+	 * @return the flattened map.
 	 */
 	protected Map<String, String> toStringMap(Map<String, Object> data) {
 		return JsonMapFlattener.flatten(data);

spring-vault-core/src/main/java/org/springframework/vault/core/lease/SecretLeaseContainer.java

@@ -60,7 +60,7 @@ import org.springframework.web.client.HttpStatusCodeException;
 /**
  * Event-based container to request secrets from Vault and renew the associated
  * {@link Lease}. Secrets can be rotated, depending on the requested
- * {@link RequestedSecret.Mode}.
+ * {@link RequestedSecret#getMode()}.
  *
  * Usage example:
  *

spring-vault-core/src/main/java/org/springframework/vault/repository/convert/VaultTypeMapper.java

@@ -29,9 +29,9 @@ import org.springframework.data.convert.TypeMapper;
 public interface VaultTypeMapper extends TypeMapper<Map<String, Object>> {
 
 	/**
-	 * Returns whether the given key is the type key.
+	 * Returns whether the given {@code key} is the type key.
 	 *
-	 * @return
+	 * @return {@literal true} if the {@code key} is the type key.
 	 */
 	boolean isTypeKey(String key);
 }

spring-vault-core/src/main/java/org/springframework/vault/repository/query/VaultQuery.java

@@ -96,7 +96,7 @@ public class VaultQuery {
 	 * Compose a new {@link VaultQuery} using predicates of {@literal this} and the
 	 * {@code other} query using logical {@code AND}.
 	 *
-	 * @param other must not be {@literal null}.
+	 * @param predicate must not be {@literal null}.
 	 * @return a new composed {@link VaultQuery}.
 	 * @see Predicate#and(Predicate)
 	 */

spring-vault-core/src/main/java/org/springframework/vault/support/AbstractResult.java

@@ -51,11 +51,11 @@ public abstract class AbstractResult<V> {
 	}
 
 	/**
-	 * Returns {@link true} if and only if the batch operation was completed successfully.
-	 * Use {@link #getCause()} to obtain the actual exception if the operation completed
-	 * with an error.
+	 * Returns {@literal true} if and only if the batch operation was completed
+	 * successfully. Use {@link #getCause()} to obtain the actual exception if the
+	 * operation completed with an error.
 	 *
-	 * @return {@link true} if the batch operation was completed successfully.
+	 * @return {@literal true} if the batch operation was completed successfully.
 	 */
 	public boolean isSuccessful() {
 		return exception == null;

spring-vault-core/src/main/java/org/springframework/vault/support/VaultTransitKeyCreationRequest.java

@@ -48,7 +48,7 @@ public class VaultTransitKeyCreationRequest {
 	/**
 	 * Create a new {@link VaultTransitKeyCreationRequest} specifically for a {@code type}
 	 * .
-	 * @param the key type to use, must not be {@literal null} or empty.
+	 * @param type the key type to use, must not be {@literal null} or empty.
 	 * @return a new {@link VaultTransitKeyCreationRequest} for the given key {@code type}
 	 * .
 	 * @since 2.0