Clarify some of the analysis server errors.

pkg/analysis_server/lib/src/generated_protocol.dart

 // Copyright (c) 2014, the Dart project authors.  Please see the AUTHORS file
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 //
 // This file has been automatically generated.  Please do not edit it manually.
 // To regenerate the file, use the script
 // "pkg/analysis_server/spec/generate_files".
 
 part of protocol;
 /**
@@ skipping 8084 matching lines @@
  *   SERVER_ALREADY_STARTED
  *   UNANALYZED_PRIORITY_FILES
  *   UNKNOWN_REQUEST
  *   UNSUPPORTED_FEATURE
  * }
  */
 class RequestErrorCode {
   /**
    * An error occurred during the processing of an "analysis.getErrors"
    * request.
+   *
+   * This is a legacy error; it will be removed before the API reaches version
+   * 1.0.
    */
   static const GET_ERRORS_ERROR = const RequestErrorCode._("GET_ERRORS_ERROR");
 
   /**
    * One of the method parameters was invalid.
    */
   static const INVALID_PARAMETER = const RequestErrorCode._("INVALID_PARAMETER");
 
   /**
    * A malformed request was received.
    */
   static const INVALID_REQUEST = const RequestErrorCode._("INVALID_REQUEST");
 
   /**
    * The analysis server has already been started (and hence won't accept new
    * connections).
+   *
+   * This error is included for future expansion; at present the analysis
+   * server can only speak to one client at a time so this error will never
+   * occur.
    */
   static const SERVER_ALREADY_STARTED = const RequestErrorCode._("SERVER_ALREADY_STARTED");
 
   /**
    * An "analysis.setPriorityFiles" request includes one or more files that are
    * not being analyzed.
+   *
+   * This is a legacy error; it will be removed before the API reaches version
+   * 1.0.
    */
   static const UNANALYZED_PRIORITY_FILES = const RequestErrorCode._("UNANALYZED_PRIORITY_FILES");
 
   /**
    * A request was received which the analysis server does not recognize, or
    * cannot handle in its current configuation.
    */
   static const UNKNOWN_REQUEST = const RequestErrorCode._("UNKNOWN_REQUEST");
 
   /**
    * The analysis server was requested to perform an action which is not
    * supported.
+   *
+   * This is a legacy error; it will be removed before the API reaches version
+   * 1.0.
    */
   static const UNSUPPORTED_FEATURE = const RequestErrorCode._("UNSUPPORTED_FEATURE");
 
   final String name;
 
   const RequestErrorCode._(this.name);
 
   factory RequestErrorCode(String name) {
     switch (name) {
       case "GET_ERRORS_ERROR":
@@ skipping 1615 matching lines @@
     return false;
   }
 
   @override
   int get hashCode {
     int hash = 0;
     hash = _JenkinsSmiHash.combine(hash, newName.hashCode);
     return _JenkinsSmiHash.finish(hash);
   }
 }