added javadoc comments and nosearch()

pom.xml

@@ -4,6 +4,7 @@
 	<groupId>redis.clients</groupId>
 	<artifactId>jedis</artifactId>
 	<version>1.2.0</version>
+	
 	<dependencies>
 		<dependency>
 			<groupId>junit</groupId>
@@ -18,6 +19,33 @@
 		<redis-hosts>localhost:6379,localhost:6380</redis-hosts>
 	</properties>
 
+	<name>Jedis</name>
+	<description>Jedis is a blazingly small and sane Redis java client.</description>
+	<url>http://github.com/xetorthio/jedis</url>
+	
+	<issueManagement>
+		<system>github</system>
+		<url>http://github.com/xetorthio/jedis</url>
+	</issueManagement>
+	
+	<scm>
+		<url>scm:git:http://github.com/xetorthio/jedis.git</url>
+	</scm>
+	
+	<mailingLists>
+		<mailingList>
+			<name>Jedis</name>
+			<subscribe>http://groups.google.com/group/jedis_redis</subscribe>
+		</mailingList>
+	</mailingLists>
+	
+	<licenses>
+		<license>
+			<name>Jedis License</name>
+			<url>http://github.com/xetorthio/jedis/raw/master/LICENSE.txt</url>
+		</license>
+	</licenses>
+	
 	<build>
 		<plugins>
 			<plugin>

src/main/java/redis/clients/jedis/SortingParams.java

@@ -5,46 +5,115 @@ import java.util.Collection;
 import java.util.Collections;
 import java.util.List;
 
+/**
+ * Builder Class for {@link Jedis#sort(String, SortingParams) SORT} Parameters.
+ * 
+ */
 public class SortingParams {
-    private List<String> params = new ArrayList<String>();
+	private List<String> params = new ArrayList<String>();
 
-    public SortingParams by(String pattern) {
+	/**
-	params.add("BY");
+	 * Sort by weight in keys.
-	params.add(pattern);
+	 * <p>
-	return this;
+	 * Takes a pattern that is used in order to generate the key names of the
-    }
+	 * weights used for sorting. Weight key names are obtained substituting the
-
+	 * first occurrence of * with the actual value of the elements on the list.
-    public Collection<String> getParams() {
+	 * <p>
-	return Collections.unmodifiableCollection(params);
+	 * The pattern for a normal key/value pair is "keyname*" and for a value in
-    }
+	 * a hash "keyname*->fieldname".
-
+	 * 
-    public SortingParams desc() {
+	 * @param pattern
-	params.add("DESC");
+	 * @return the SortingParams Object
-	return this;
+	 */
-    }
+	public SortingParams by(String pattern) {
-
+		params.add("BY");
-    public SortingParams asc() {
+		params.add(pattern);
-	params.add("ASC");
+		return this;
-	return this;
+	}
-    }
+
-
+	/**
-    public SortingParams limit(int start, int count) {
+	 * No sorting.
-	params.add("LIMIT");
+	 * <p>
-	params.add(String.valueOf(start));
+	 * This is useful if you want to retrieve a external key (using
-	params.add(String.valueOf(count));
+	 * {@link #get(String...) GET}) but you don't want the sorting overhead.
-	return this;
+	 * 
-    }
+	 * @return the SortingParams Object
-
+	 */
-    public SortingParams alpha() {
+	public SortingParams nosort() {
-	params.add("ALPHA");
+		params.add("BY nosort");
-	return this;
+		return this;
-    }
+	}
-
+
-    public SortingParams get(String... patterns) {
+	public Collection<String> getParams() {
-	for (String pattern : patterns) {
+		return Collections.unmodifiableCollection(params);
-	    params.add("GET");
+	}
-	    params.add(pattern);
+
+	/**
+	 * Get the Sorting in Descending Order.
+	 * 
+	 * @return the sortingParams Object
+	 */
+	public SortingParams desc() {
+		params.add("DESC");
+		return this;
+	}
+
+	/**
+	 * Get the Sorting in Ascending Order. This is the default order.
+	 * 
+	 * @return the SortingParams Object
+	 */
+	public SortingParams asc() {
+		params.add("ASC");
+		return this;
+	}
+
+	/**
+	 * Limit the Numbers of returned Elements.
+	 * 
+	 * @param start
+	 *            is zero based
+	 * @param count
+	 * @return the SortingParams Object
+	 */
+	public SortingParams limit(int start, int count) {
+		params.add("LIMIT");
+		params.add(String.valueOf(start));
+		params.add(String.valueOf(count));
+		return this;
+	}
+
+	/**
+	 * Sort lexicographicaly. Note that Redis is utf-8 aware assuming you set
+	 * the right value for the LC_COLLATE environment variable.
+	 * 
+	 * @return the SortingParams Object
+	 */
+	public SortingParams alpha() {
+		params.add("ALPHA");
+		return this;
+	}
+
+	/**
+	 * Retrieving external keys from the result of the search.
+	 * <p>
+	 * Takes a pattern that is used in order to generate the key names of the
+	 * result of sorting. The key names are obtained substituting the
+	 * first occurrence of * with the actual value of the elements on the list.
+	 * <p>
+	 * The pattern for a normal key/value pair is "keyname*" and for a value in
+	 * a hash "keyname*->fieldname".
+	 * <p>
+	 * To get the list itself use the char # as pattern. 
+	 * 
+	 * @param patterns
+	 * @return the SortingParams Object
+	 */
+	public SortingParams get(String... patterns) {
+		for (String pattern : patterns) {
+			params.add("GET");
+			params.add(pattern);
+		}
+		return this;
 	}
-	return this;
-    }
 }