Proposal for RefactoringMethodParameter.

pkg/analysis_server/doc/api.html

Index: pkg/analysis_server/doc/api.html
diff --git a/pkg/analysis_server/doc/api.html b/pkg/analysis_server/doc/api.html
index 7175c95148ba6f72b609d491ea0bd5115b7dd490..13e7ca85c3e8c1d0c4236155c995dba409da41f4 100644
--- a/pkg/analysis_server/doc/api.html
+++ b/pkg/analysis_server/doc/api.html
@@ -2450,21 +2450,6 @@ dt.typeDefinition {
             <p>
               The name of the class in which the member is defined.
             </p>
-          </dd></dl></dd><dt class="typeDefinition"><a name="type_Parameter">Parameter: object</a></dt><dd>
-        <p>
-          A description of a parameter.
-        </p>
-        
-      <dl><dt class="field"><b><i>type ( String )</i></b></dt><dd>
-            
-            <p>
-              The type that should be given to the parameter.
-            </p>
-          </dd><dt class="field"><b><i>name ( String )</i></b></dt><dd>
-            
-            <p>
-              The name that should be given to the parameter.
-            </p>
           </dd></dl></dd><dt class="typeDefinition"><a name="type_Position">Position: object</a></dt><dd>
         <p>
           A position within a file.
@@ -2486,7 +2471,28 @@ dt.typeDefinition {
           created.
         </p>
         
-      <dl><dt class="value">CONVERT_GETTER_TO_METHOD</dt><dt class="value">CONVERT_METHOD_TO_GETTER</dt><dt class="value">EXTRACT_LOCAL_VARIABLE</dt><dt class="value">EXTRACT_METHOD</dt><dt class="value">INLINE_LOCAL_VARIABLE</dt><dt class="value">INLINE_METHOD</dt><dt class="value">RENAME</dt></dl></dd><dt class="typeDefinition"><a name="type_RefactoringProblem">RefactoringProblem: object</a></dt><dd>
+      <dl><dt class="value">CONVERT_GETTER_TO_METHOD</dt><dt class="value">CONVERT_METHOD_TO_GETTER</dt><dt class="value">EXTRACT_LOCAL_VARIABLE</dt><dt class="value">EXTRACT_METHOD</dt><dt class="value">INLINE_LOCAL_VARIABLE</dt><dt class="value">INLINE_METHOD</dt><dt class="value">RENAME</dt></dl></dd><dt class="typeDefinition"><a name="type_RefactoringMethodParameter">RefactoringMethodParameter: object</a></dt><dd>
+        <p>
+          A description of a parameter in a method refactoring.
+        </p>
+        
+      <dl><dt class="field"><b><i>id ( <span style="color:#999999">optional</span> String )</i></b></dt><dd>
+            
+            <p>
+              The unique identifier of the parameter.
+              Clients may omit this field for the parameters they want to add.
+            </p>
+          </dd><dt class="field"><b><i>type ( String )</i></b></dt><dd>
+            
+            <p>
+              The type that should be given to the parameter.
+            </p>
+          </dd><dt class="field"><b><i>name ( String )</i></b></dt><dd>
+            
+            <p>
+              The name that should be given to the parameter.
+            </p>
+          </dd></dl></dd><dt class="typeDefinition"><a name="type_RefactoringProblem">RefactoringProblem: object</a></dt><dd>
         <p>
           A description of a problem related to a refactoring.
         </p>
@@ -2848,7 +2854,7 @@ dt.typeDefinition {
             <p>
               True if a getter could be created rather than a method.
             </p>
-          </dd><dt class="field"><b><i>parameters ( List&lt;<a href="#type_Parameter">Parameter</a>&gt; )</i></b></dt><dd>
+          </dd><dt class="field"><b><i>parameters ( List&lt;<a href="#type_RefactoringMethodParameter">RefactoringMethodParameter</a>&gt; )</i></b></dt><dd>
             
             <p>
               The proposed parameters for the method.
@@ -2891,10 +2897,13 @@ dt.typeDefinition {
             <p>
               The name that the method should be given.
             </p>
-          </dd><dt class="field"><b><i>parameters ( List&lt;<a href="#type_Parameter">Parameter</a>&gt; )</i></b></dt><dd>
+          </dd><dt class="field"><b><i>parameters ( List&lt;<a href="#type_RefactoringMethodParameter">RefactoringMethodParameter</a>&gt; )</i></b></dt><dd>
             
             <p>
               The parameters that should be defined for the method.
+              Clients may change order of proposed parameters, add new ones
+              or omit some parameters (corresponding parameters will not be
+              generated).
             </p>
           </dd><dt class="field"><b><i>extractAll ( bool )</i></b></dt><dd>