detailed deprecation comments for the major request handlers

git-svn-id: https://svn.apache.org/repos/asf/lucene/solr/trunk@630746 13f79535-47bb-0310-9956-ffa450edef68

example/solr/conf/schema.xml

@@ -338,6 +338,7 @@
         or to add multiple fields to the same field for easier/faster searching.  -->
    <copyField source="id" dest="sku"/>
 
+   <copyField source="incubationdate_dt" dest="incubationdate_s"/>
    <copyField source="cat" dest="text"/>
    <copyField source="name" dest="text"/>
    <copyField source="name" dest="nameSort"/>

src/java/org/apache/solr/handler/DisMaxRequestHandler.java

@@ -113,6 +113,7 @@ import java.net.URL;
  * :TODO: document facet param support
  *
  * </pre>
+ * @deprecated use StandardRequestHandler with a "defType=dismax" param
  */
 @Deprecated
 public class DisMaxRequestHandler extends StandardRequestHandler  

src/java/org/apache/solr/request/DisMaxRequestHandler.java

@@ -19,6 +19,7 @@ package org.apache.solr.request;
 
 /**
  * This class is scheduled for deletion.  Please update your code to the moved package.
+ * @deprecated use org.apache.solr.handler.DisMaxRequestHandler
  */
 @Deprecated 
 public class DisMaxRequestHandler extends org.apache.solr.handler.DisMaxRequestHandler  {

src/java/org/apache/solr/request/StandardRequestHandler.java

@@ -19,6 +19,7 @@ package org.apache.solr.request;
 
 /**
  * This class is scheduled for deletion.  Please update your code to the moved package.
+ * @deprecated use org.apache.solr.handler.StandardRequestHandler
  */
 @Deprecated 
 public class StandardRequestHandler extends org.apache.solr.handler.StandardRequestHandler {