Some comments added

src/main/java/org/redisson/RedissonDeque.java

@@ -17,7 +17,6 @@ package org.redisson;
 
 import java.util.Iterator;
 import java.util.List;
-import java.util.ListIterator;
 import java.util.NoSuchElementException;
 
 import org.redisson.connection.ConnectionManager;
@@ -26,11 +25,11 @@ import org.redisson.core.RDeque;
 import com.lambdaworks.redis.RedisConnection;
 
 /**
- *
+ * Distributed and concurrent implementation of {@link java.util.Queue}
  *
  * @author Nikita Koksharov
  *
- * @param <V>
+ * @param <V> the type of elements held in this collection
  */
 public class RedissonDeque<V> extends RedissonQueue<V> implements RDeque<V> {
 

src/main/java/org/redisson/RedissonList.java

@@ -33,7 +33,7 @@ import com.lambdaworks.redis.RedisConnection;
  *
  * @author Nikita Koksharov
  *
- * @param <V> value
+ * @param <V> the type of elements held in this collection
  */
 public class RedissonList<V> extends RedissonExpirable implements RList<V> {
 

src/main/java/org/redisson/RedissonQueue.java

@@ -23,11 +23,11 @@ import org.redisson.core.RQueue;
 import com.lambdaworks.redis.RedisConnection;
 
 /**
- * Distributed and concurrent implementation of {@link java.util.List}
+ * Distributed and concurrent implementation of {@link java.util.Queue}
  *
  * @author Nikita Koksharov
  *
- * @param <V> value
+ * @param <V> the type of elements held in this collection
  */
 public class RedissonQueue<V> extends RedissonList<V> implements RQueue<V> {
 

src/main/java/org/redisson/core/RDeque.java

@@ -18,10 +18,11 @@ package org.redisson.core;
 import java.util.Deque;
 
 /**
+ * {@link java.util.Deque} backed by Redis
  *
  * @author Nikita Koksharov
  *
- * @param <V>
+ * @param <V> the type of elements held in this collection
  */
 public interface RDeque<V> extends Deque<V>, RExpirable {
 

src/main/java/org/redisson/core/RExpirable.java

@@ -18,6 +18,12 @@ package org.redisson.core;
 import java.util.Date;
 import java.util.concurrent.TimeUnit;
 
+/**
+ * Interface with expiration support for Redisson objects.
+ *
+ * @author Nikita Koksharov
+ *
+ */
 public interface RExpirable extends RObject {
 
     boolean expire(long timeToLive, TimeUnit timeUnit);
@@ -26,8 +32,19 @@ public interface RExpirable extends RObject {
 
     boolean expireAt(Date timestamp);
 
+    /**
+     * Remove the existing timeout of Redisson object
+     *
+     * @return <code>true</code> if timeout was removed
+     *         <code>false</code> if object does not exist or does not have an associated timeout
+     */
     boolean clearExpire();
 
+    /**
+     * Remaining time in seconds to live of Redisson object that has a timeout
+     *
+     * @return time in seconds
+     */
     long remainTimeToLive();
 
 }

src/main/java/org/redisson/core/RList.java

@@ -22,7 +22,7 @@ import java.util.List;
  *
  * @author Nikita Koksharov
  *
- * @param <V> value
+ * @param <V> the type of elements held in this collection
  */
 public interface RList<V> extends List<V>, RExpirable {
 

src/main/java/org/redisson/core/RQueue.java

@@ -18,11 +18,11 @@ package org.redisson.core;
 import java.util.Queue;
 
 /**
- * Distributed and concurrent implementation of {@link java.util.List}
+ * {@link java.util.Queue} backed by Redis
  *
  * @author Nikita Koksharov
  *
- * @param <V> value
+ * @param <V> the type of elements held in this collection
  */
 public interface RQueue<V> extends Queue<V>, RExpirable {