| OLD | NEW |
| 1 <!doctype html> | 1 <!doctype html> |
| 2 <html> | 2 <html> |
| 3 <head> | 3 <head> |
| 4 <meta charset="UTF-8"/> | 4 <meta charset="UTF-8"/> |
| 5 <title>Analysis Server API Specification</title> | 5 <title>Analysis Server API Specification</title> |
| 6 </head> | 6 </head> |
| 7 <body> | 7 <body> |
| 8 <h1>Analysis Server API Specification</h1> | 8 <h1>Analysis Server API Specification</h1> |
| 9 <h1 style="color:#999999">Version <version>1.18.0</version></h1> | 9 <h1 style="color:#999999">Version <version>1.18.0</version></h1> |
| 10 <p> | 10 <p> |
| (...skipping 23 matching lines...) Expand all Loading... |
| 34 for readability. | 34 for readability. |
| 35 </p> | 35 </p> |
| 36 <p> | 36 <p> |
| 37 It is the client's responsibility to read output from the server to | 37 It is the client's responsibility to read output from the server to |
| 38 avoid its blocking. | 38 avoid its blocking. |
| 39 </p> | 39 </p> |
| 40 <p> | 40 <p> |
| 41 To ease interoperability with Lisp-based clients (which may not | 41 To ease interoperability with Lisp-based clients (which may not |
| 42 be able to easily distinguish between empty lists, empty maps, | 42 be able to easily distinguish between empty lists, empty maps, |
| 43 and null), client-to-server communication is allowed to replace | 43 and null), client-to-server communication is allowed to replace |
| 44 any instance of "<tt>{}</tt>" or "<tt>[]</tt>" with null. The | 44 any instance of “<tt>{}</tt>” or “<tt>[]</tt>” with null. The |
| 45 server will always properly represent empty lists as | 45 server will always properly represent empty lists as |
| 46 "<tt>[]</tt>" and empty maps as "<tt>{}</tt>". | 46 “<tt>[]</tt>” and empty maps as “<tt>{}</tt>”. |
| 47 </p> | 47 </p> |
| 48 <h3>Communication Structure</h3> | 48 <h3>Communication Structure</h3> |
| 49 <p> | 49 <p> |
| 50 Clients can make a request of the server and the server will | 50 Clients can make a request of the server and the server will |
| 51 provide a response for each request that it receives. While many | 51 provide a response for each request that it receives. While many |
| 52 of the requests that can be made by a client are informational | 52 of the requests that can be made by a client are informational |
| 53 in nature, we have chosen to always return a response so that | 53 in nature, we have chosen to always return a response so that |
| 54 clients can know whether the request was received and was | 54 clients can know whether the request was received and was |
| 55 correct. | 55 correct. |
| 56 </p> | 56 </p> |
| (...skipping 1669 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 1726 </p> | 1726 </p> |
| 1727 </field> | 1727 </field> |
| 1728 <field name="options" optional="true"> | 1728 <field name="options" optional="true"> |
| 1729 <ref>RefactoringOptions</ref> | 1729 <ref>RefactoringOptions</ref> |
| 1730 <p> | 1730 <p> |
| 1731 Data used to provide values provided by the user. The | 1731 Data used to provide values provided by the user. The |
| 1732 structure of the data is dependent on the kind of | 1732 structure of the data is dependent on the kind of |
| 1733 refactoring being performed. The data that is expected is | 1733 refactoring being performed. The data that is expected is |
| 1734 documented in the section titled <a | 1734 documented in the section titled <a |
| 1735 href="#refactorings">Refactorings</a>, labeled as | 1735 href="#refactorings">Refactorings</a>, labeled as |
| 1736 "Options". This field can be omitted if the refactoring | 1736 “Options”. This field can be omitted if the refactoring |
| 1737 does not require any options or if the values of those | 1737 does not require any options or if the values of those |
| 1738 options are not known. | 1738 options are not known. |
| 1739 </p> | 1739 </p> |
| 1740 </field> | 1740 </field> |
| 1741 </params> | 1741 </params> |
| 1742 <result> | 1742 <result> |
| 1743 <field name="initialProblems"> | 1743 <field name="initialProblems"> |
| 1744 <list><ref>RefactoringProblem</ref></list> | 1744 <list><ref>RefactoringProblem</ref></list> |
| 1745 <p> | 1745 <p> |
| 1746 The initial status of the refactoring, i.e. problems related to | 1746 The initial status of the refactoring, i.e. problems related to |
| (...skipping 20 matching lines...) Expand all Loading... |
| 1767 </p> | 1767 </p> |
| 1768 </field> | 1768 </field> |
| 1769 <field name="feedback" optional="true"> | 1769 <field name="feedback" optional="true"> |
| 1770 <ref>RefactoringFeedback</ref> | 1770 <ref>RefactoringFeedback</ref> |
| 1771 <p> | 1771 <p> |
| 1772 Data used to provide feedback to the user. The structure | 1772 Data used to provide feedback to the user. The structure |
| 1773 of the data is dependent on the kind of refactoring | 1773 of the data is dependent on the kind of refactoring |
| 1774 being created. The data that is returned is documented | 1774 being created. The data that is returned is documented |
| 1775 in the section titled <a | 1775 in the section titled <a |
| 1776 href="#refactorings">Refactorings</a>, labeled as | 1776 href="#refactorings">Refactorings</a>, labeled as |
| 1777 "Feedback". | 1777 “Feedback”. |
| 1778 </p> | 1778 </p> |
| 1779 </field> | 1779 </field> |
| 1780 <field name="change" optional="true"> | 1780 <field name="change" optional="true"> |
| 1781 <ref>SourceChange</ref> | 1781 <ref>SourceChange</ref> |
| 1782 <p> | 1782 <p> |
| 1783 The changes that are to be applied to affect the | 1783 The changes that are to be applied to affect the |
| 1784 refactoring. This field will be omitted if there are | 1784 refactoring. This field will be omitted if there are |
| 1785 problems that prevent a set of changes from being | 1785 problems that prevent a set of changes from being |
| 1786 computed, such as having no options specified for a | 1786 computed, such as having no options specified for a |
| 1787 refactoring that requires them, or if only validation | 1787 refactoring that requires them, or if only validation |
| (...skipping 190 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 1978 <ref>String</ref> | 1978 <ref>String</ref> |
| 1979 <p> | 1979 <p> |
| 1980 The URI to which the file path was mapped. This field is omitted | 1980 The URI to which the file path was mapped. This field is omitted |
| 1981 if the file field was not given in the request. | 1981 if the file field was not given in the request. |
| 1982 </p> | 1982 </p> |
| 1983 </field> | 1983 </field> |
| 1984 </result> | 1984 </result> |
| 1985 </request> | 1985 </request> |
| 1986 <request method="setSubscriptions"> | 1986 <request method="setSubscriptions"> |
| 1987 <p> | 1987 <p> |
| 1988 <b><i>Deprecated</i></b>: the analysis server no longer fires | |
| 1989 <tt>LAUNCH_DATA</tt> events. | |
| 1990 </p> | |
| 1991 <p> | |
| 1992 Subscribe for services. All previous subscriptions are replaced by the | 1988 Subscribe for services. All previous subscriptions are replaced by the |
| 1993 given set of services. | 1989 given set of services. |
| 1994 </p> | 1990 </p> |
| 1995 <p> | 1991 <p> |
| 1996 It is an error if any of the elements in the list are not valid | 1992 It is an error if any of the elements in the list are not valid |
| 1997 services. If there is an error, then the current subscriptions will | 1993 services. If there is an error, then the current subscriptions will |
| 1998 remain unchanged. | 1994 remain unchanged. |
| 1999 </p> | 1995 </p> |
| 2000 <params> | 1996 <params> |
| 2001 <field name="subscriptions"> | 1997 <field name="subscriptions"> |
| (...skipping 1122 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 3124 <p> | 3120 <p> |
| 3125 A human-readable description of the element being | 3121 A human-readable description of the element being |
| 3126 referenced. This data is omitted if there is no referenced | 3122 referenced. This data is omitted if there is no referenced |
| 3127 element. | 3123 element. |
| 3128 </p> | 3124 </p> |
| 3129 </field> | 3125 </field> |
| 3130 <field name="elementKind" optional="true"> | 3126 <field name="elementKind" optional="true"> |
| 3131 <ref>String</ref> | 3127 <ref>String</ref> |
| 3132 <p> | 3128 <p> |
| 3133 A human-readable description of the kind of element being | 3129 A human-readable description of the kind of element being |
| 3134 referenced (such as "class" or "function type | 3130 referenced (such as “class” or “function type |
| 3135 alias"). This data is omitted if there is no referenced | 3131 alias”). This data is omitted if there is no referenced |
| 3136 element. | 3132 element. |
| 3137 </p> | 3133 </p> |
| 3138 </field> | 3134 </field> |
| 3139 <field name="isDeprecated" optional="true"> | 3135 <field name="isDeprecated" optional="true"> |
| 3140 <ref>bool</ref> | 3136 <ref>bool</ref> |
| 3141 <p> | 3137 <p> |
| 3142 True if the referenced element is deprecated. | 3138 True if the referenced element is deprecated. |
| 3143 </p> | 3139 </p> |
| 3144 </field> | 3140 </field> |
| 3145 <field name="parameter" optional="true"> | 3141 <field name="parameter" optional="true"> |
| (...skipping 1407 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 4553 <field name="length"> | 4549 <field name="length"> |
| 4554 <ref>int</ref> | 4550 <ref>int</ref> |
| 4555 <p> | 4551 <p> |
| 4556 The length of the name selected to be renamed. | 4552 The length of the name selected to be renamed. |
| 4557 </p> | 4553 </p> |
| 4558 </field> | 4554 </field> |
| 4559 <field name="elementKindName"> | 4555 <field name="elementKindName"> |
| 4560 <ref>String</ref> | 4556 <ref>String</ref> |
| 4561 <p> | 4557 <p> |
| 4562 The human-readable description of the kind of element being | 4558 The human-readable description of the kind of element being |
| 4563 renamed (such as "class" or "function type | 4559 renamed (such as “class” or “function type |
| 4564 alias"). | 4560 alias”). |
| 4565 </p> | 4561 </p> |
| 4566 </field> | 4562 </field> |
| 4567 <field name="oldName"> | 4563 <field name="oldName"> |
| 4568 <ref>String</ref> | 4564 <ref>String</ref> |
| 4569 <p> | 4565 <p> |
| 4570 The old name of the element before the refactoring. | 4566 The old name of the element before the refactoring. |
| 4571 </p> | 4567 </p> |
| 4572 </field> | 4568 </field> |
| 4573 </feedback> | 4569 </feedback> |
| 4574 <options> | 4570 <options> |
| (...skipping 12 matching lines...) Expand all Loading... |
| 4587 This section contains a list of all of the errors that are | 4583 This section contains a list of all of the errors that are |
| 4588 produced by the server and the data that is returned with each. | 4584 produced by the server and the data that is returned with each. |
| 4589 </p> | 4585 </p> |
| 4590 <p> | 4586 <p> |
| 4591 TODO: TBD | 4587 TODO: TBD |
| 4592 </p> | 4588 </p> |
| 4593 <h2 class="domain"><a name="index">Index</a></h2> | 4589 <h2 class="domain"><a name="index">Index</a></h2> |
| 4594 <index></index> | 4590 <index></index> |
| 4595 </body> | 4591 </body> |
| 4596 </html> | 4592 </html> |
| OLD | NEW |