Analysis server format service wiring (and protocol doc update).

pkg/analysis_server/doc/api.html

Index: pkg/analysis_server/doc/api.html
===================================================================
--- pkg/analysis_server/doc/api.html	(revision 42828)
+++ pkg/analysis_server/doc/api.html	(working copy)
@@ -1441,6 +1441,13 @@
           matching the original as possible, but whitespace at the beginning or
           end of the selected region will be ignored.
         </p>
+        <p>
+          If a request is made for a file which does not exist, or
+          which 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
+          <tt>FORMAT_INVALID_FILE</tt> will be generated.
+        </p>
         
         
       <h4>Parameters</h4><dl><dt class="field"><b><i>file ( <a href="#type_FilePath">FilePath</a> )</i></b></dt><dd>
@@ -2967,6 +2974,12 @@
               not be satisfied because the content of the file changed before
               the requested results could be computed.
             </p>
+          </dd><dt class="value">FORMAT_INVALID_FILE</dt><dd>
+            
+            <p>
+              An "edit.format" request specified a FilePath
+              which does not match a Dart file in an analysis root.
+            </p>
           </dd><dt class="value">GET_ERRORS_INVALID_FILE</dt><dd>
             
             <p>