You are viewing a plain text version of this content. The canonical link for it is here.
Posted to java-commits@lucene.apache.org by mi...@apache.org on 2009/07/17 20:23:30 UTC
svn commit: r795179 - /lucene/java/trunk/src/java/org/apache/lucene/search/Sort.java

Author: mikemccand
Date: Fri Jul 17 18:23:30 2009
New Revision: 795179

URL: http://svn.apache.org/viewvc?rev=795179&view=rev
Log:
LUCENE-1665: also deprecate short-hand ctors/setters in Sort that imply SortField.AUTO

Modified:
    lucene/java/trunk/src/java/org/apache/lucene/search/Sort.java

Modified: lucene/java/trunk/src/java/org/apache/lucene/search/Sort.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/src/java/org/apache/lucene/search/Sort.java?rev=795179&r1=795178&r2=795179&view=diff
==============================================================================
--- lucene/java/trunk/src/java/org/apache/lucene/search/Sort.java (original)
+++ lucene/java/trunk/src/java/org/apache/lucene/search/Sort.java Fri Jul 17 18:23:30 2009
@@ -130,6 +130,9 @@
    * automatically.
    * 
    * @see SortField#AUTO
+   * @deprecated Please specify the type explicitly by
+   * first creating a {@link SortField} and then use {@link
+   * #Sort(SortField)}
    */
   public Sort(String field) {
     setSort(field, false);
@@ -141,6 +144,9 @@
    * determined automatically.
    * 
    * @see SortField#AUTO
+   * @deprecated Please specify the type explicitly by
+   * first creating a {@link SortField} and then use {@link
+   * #Sort(SortField)}
    */
   public Sort(String field, boolean reverse) {
     setSort(field, reverse);
@@ -151,6 +157,9 @@
    * <code>field</code> is determined automatically.
    * 
    * @see SortField#AUTO
+   * @deprecated Please specify the type explicitly by
+   * first creating {@link SortField}s and then use {@link
+   * #Sort(SortField[])}
    */
   public Sort(String[] fields) {
     setSort(fields);
@@ -169,6 +178,9 @@
   /**
    * Sets the sort to the terms in <code>field</code> then by index order
    * (document number).
+   * @deprecated Please specify the type explicitly by
+   * first creating a {@link SortField} and then use {@link
+   * #setSort(SortField)}
    */
   public final void setSort(String field) {
     setSort(field, false);
@@ -177,12 +189,18 @@
   /**
    * Sets the sort to the terms in <code>field</code> possibly in reverse,
    * then by index order (document number).
+   * @deprecated Please specify the type explicitly by
+   * first creating a {@link SortField} and then use {@link
+   * #setSort(SortField)}
    */
   public void setSort(String field, boolean reverse) {
     fields = new SortField[] { new SortField(field, SortField.AUTO, reverse) };
   }
 
-  /** Sets the sort to the terms in each field in succession. */
+  /** Sets the sort to the terms in each field in succession.
+   * @deprecated Please specify the type explicitly by
+   * first creating {@link SortField}s and then use {@link
+   * #setSort(SortField[])} */
   public void setSort(String[] fieldnames) {
     final int n = fieldnames.length;
     SortField[] nfields = new SortField[n];