DATAREDIS-763 - Polishing.

Update Javadoc.

Original Pull Request: #333

src/main/java/org/springframework/data/redis/cache/RedisCacheConfiguration.java

@@ -52,9 +52,9 @@ public class RedisCacheConfiguration {
 	private final ConversionService conversionService;
 
 	@SuppressWarnings("unchecked")
-	private RedisCacheConfiguration(Duration ttl, Boolean cacheNullValues, Boolean usePrefix,
-			CacheKeyPrefix keyPrefix, SerializationPair<String> keySerializationPair,
-			SerializationPair<?> valueSerializationPair, ConversionService conversionService) {
+	private RedisCacheConfiguration(Duration ttl, Boolean cacheNullValues, Boolean usePrefix, CacheKeyPrefix keyPrefix,
+			SerializationPair<String> keySerializationPair, SerializationPair<?> valueSerializationPair,
+			ConversionService conversionService) {
 
 		this.ttl = ttl;
 		this.cacheNullValues = cacheNullValues;
@@ -111,6 +111,8 @@ public class RedisCacheConfiguration {
 	 * cache key converters</dd>
 	 * </dl>
 	 *
+	 * @param classLoader the {@link ClassLoader} used for deserialization by the
+	 *          {@link org.springframework.data.redis.serializer.JdkSerializationRedisSerializer}.
 	 * @return new {@link RedisCacheConfiguration}.
 	 * @since 2.1
 	 */

src/main/java/org/springframework/data/redis/serializer/JdkSerializationRedisSerializer.java

@@ -48,7 +48,7 @@ public class JdkSerializationRedisSerializer implements RedisSerializer<Object>
 	/**
 	 * Creates a new {@link JdkSerializationRedisSerializer} using a {@link ClassLoader}.
 	 *
-	 * @param classLoader
+	 * @param classLoader the {@link ClassLoader} to use for deserialization. Can be {@literal null}.
 	 * @since 1.7
 	 */
 	public JdkSerializationRedisSerializer(@Nullable ClassLoader classLoader) {

src/main/java/org/springframework/data/redis/serializer/RedisSerializationContext.java

@@ -88,9 +88,9 @@ public interface RedisSerializationContext<K, V> {
 	}
 
 	/**
-	 * Creates a new {@link RedisSerializationContext} using {@link JdkSerializationRedisSerializer}.
+	 * Creates a new {@link RedisSerializationContext} using a {@link JdkSerializationRedisSerializer}.
 	 *
-	 * @return
+	 * @return new instance of {@link RedisSerializationContext}.
 	 * @since 2.1
 	 */
 	static RedisSerializationContext<Object, Object> java() {
@@ -98,11 +98,11 @@ public interface RedisSerializationContext<K, V> {
 	}
 
 	/**
-	 * Creates a new {@link RedisSerializationContext} using {@link JdkSerializationRedisSerializer} given
+	 * Creates a new {@link RedisSerializationContext} using a {@link JdkSerializationRedisSerializer} with given
 	 * {@link ClassLoader}.
 	 *
-	 * @param classLoader the classloader to use.
-	 * @return
+	 * @param classLoader the {@link ClassLoader} to use for deserialization. Can be {@literal null}.
+	 * @return new instance of {@link RedisSerializationContext}.
 	 * @since 2.1
 	 */
 	static RedisSerializationContext<Object, Object> java(ClassLoader classLoader) {
@@ -137,7 +137,7 @@ public interface RedisSerializationContext<K, V> {
 	 * @return
 	 */
 	static <T> RedisSerializationContext<T, T> just(SerializationPair<T> serializationPair) {
-		return RedisSerializationContext.<T, T>newSerializationContext(serializationPair).build();
+		return RedisSerializationContext.<T, T> newSerializationContext(serializationPair).build();
 	}
 
 	/**

src/main/java/org/springframework/data/redis/serializer/RedisSerializer.java

@@ -61,8 +61,8 @@ public interface RedisSerializer<T> {
 	 * Obtain a {@link RedisSerializer} using java serialization with the given {@link ClassLoader}.<br />
 	 * <strong>Note:</strong> Ensure that your domain objects are actually {@link java.io.Serializable serializable}.
 	 *
-	 * @param classLoader the classloader to use..
-	 * @return never {@literal null}.
+	 * @param classLoader the {@link ClassLoader} to use for deserialization. Can be {@literal null}.
+	 * @return new instance of {@link RedisSerializer}. Never {@literal null}.
 	 * @since 2.1
 	 */
 	static RedisSerializer<Object> java(@Nullable ClassLoader classLoader) {