Forward Kythe requests to plugins and merge in the results

pkg/analysis_server/tool/spec/generated/java/AnalysisServer.java

 /*
  * Copyright (c) 2015, the Dart project authors.
  *
  * Licensed under the Eclipse Public License v1.0 (the "License"); you may not use this file except
  * in compliance with the License. You may obtain a copy of the License at
  *
  * http://www.eclipse.org/legal/epl-v10.html
  *
  * Unless required by applicable law or agreed to in writing, software distributed under the License
  * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
@@ skipping 619 matching lines @@
    * Return {@code true} if the socket is open.
    */
   public boolean isSocketOpen();
 
   /**
    * {@code kythe.getKytheEntries}
    *
    * Return the list of KytheEntry objects for some file, given the current state of the file system
    * populated by "analysis.updateContent".
    *
+   * If a request is made for a file that does not exist, or that is not currently subject to
+   * analysis (e.g. because it is not associated with any analysis root specified to
+   * analysis.setAnalysisRoots), an error of type GET_KYTHE_ENTRIES_INVALID_FILE will be generated.
+   *
    * @param file The file containing the code for which the Kythe Entry objects are being requested.
    */
   public void kythe_getKytheEntries(String file, GetKytheEntriesConsumer consumer);
 
   /**
    * Remove the given listener from the list of listeners that will receive notification when new
      * analysis results become available.
    *
    * @param listener the listener to be removed
    */
@@ skipping 94 matching lines @@
    * the response to this request has been sent.
    */
   public void server_shutdown();
 
   /**
    * Start the analysis server.
    */
   public void start() throws Exception;
 
 }