| OLD | NEW |
| 1 <html><head> | 1 <html><head> |
| 2 <meta charset="UTF-8"> | 2 <meta charset="UTF-8"> |
| 3 <title>Analysis Server API Specification</title> | 3 <title>Analysis Server API Specification</title> |
| 4 <style>body { | 4 <style>body { |
| 5 font-family: sans-serif, serif; | 5 font-family: sans-serif, serif; |
| 6 padding-left: 5%; | 6 padding-left: 5%; |
| 7 padding-right: 5%; | 7 padding-right: 5%; |
| 8 } | 8 } |
| 9 h1 { | 9 h1 { |
| 10 text-align: center; | 10 text-align: center; |
| (...skipping 320 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 331 | 331 |
| 332 | 332 |
| 333 | 333 |
| 334 | 334 |
| 335 | 335 |
| 336 | 336 |
| 337 | 337 |
| 338 | 338 |
| 339 | 339 |
| 340 | 340 |
| 341 |
| 342 |
| 341 <h3>Requests</h3><dl><dt class="request">analysis.getErrors</dt><dd><div cla
ss="box"><pre>request: { | 343 <h3>Requests</h3><dl><dt class="request">analysis.getErrors</dt><dd><div cla
ss="box"><pre>request: { |
| 342 "id": String | 344 "id": String |
| 343 "method": "analysis.getErrors" | 345 "method": "analysis.getErrors" |
| 344 "params": { | 346 "params": { |
| 345 "<b>file</b>": <a href="#type_FilePath">FilePath</a> | 347 "<b>file</b>": <a href="#type_FilePath">FilePath</a> |
| 346 } | 348 } |
| 347 }</pre><br><pre>response: { | 349 }</pre><br><pre>response: { |
| 348 "id": String | 350 "id": String |
| 349 "error": <span style="color:#999999">optional</span> <a href="#type_RequestErr
or">RequestError</a> | 351 "error": <span style="color:#999999">optional</span> <a href="#type_RequestErr
or">RequestError</a> |
| 350 "result": { | 352 "result": { |
| (...skipping 55 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 406 Return the hover information associate with the given | 408 Return the hover information associate with the given |
| 407 location. If some or all of the hover information is not | 409 location. If some or all of the hover information is not |
| 408 available at the time this request is processed the | 410 available at the time this request is processed the |
| 409 information will be omitted from the response. | 411 information will be omitted from the response. |
| 410 </p> | 412 </p> |
| 411 | 413 |
| 412 | 414 |
| 413 <h4>Parameters</h4><dl><dt class="field"><b><i>file ( <a href="#type_FileP
ath">FilePath</a> )</i></b></dt><dd> | 415 <h4>Parameters</h4><dl><dt class="field"><b><i>file ( <a href="#type_FileP
ath">FilePath</a> )</i></b></dt><dd> |
| 414 | 416 |
| 415 <p> | 417 <p> |
| 416 The file in which hover information is being | 418 The file in which hover information is being requested. |
| 417 requested. | |
| 418 </p> | 419 </p> |
| 419 </dd><dt class="field"><b><i>offset ( int )</i></b></dt><dd> | 420 </dd><dt class="field"><b><i>offset ( int )</i></b></dt><dd> |
| 420 | 421 |
| 421 <p> | 422 <p> |
| 422 The offset for which hover information is being | 423 The offset for which hover information is being requested. |
| 423 requested. | |
| 424 </p> | 424 </p> |
| 425 </dd></dl><h4>Returns</h4><dl><dt class="field"><b><i>hovers ( List<
;<a href="#type_HoverInformation">HoverInformation</a>> )</i></b></dt><dd> | 425 </dd></dl><h4>Returns</h4><dl><dt class="field"><b><i>hovers ( List<
;<a href="#type_HoverInformation">HoverInformation</a>> )</i></b></dt><dd> |
| 426 | 426 |
| 427 <p> | 427 <p> |
| 428 The hover information associated with the | 428 The hover information associated with the |
| 429 location. The list will be empty if no information | 429 location. The list will be empty if no information |
| 430 could be determined for the location. The list can | 430 could be determined for the location. The list can |
| 431 contain multiple items if the file is being analyzed | 431 contain multiple items if the file is being analyzed |
| 432 in multiple contexts in conflicting ways (such as a | 432 in multiple contexts in conflicting ways (such as a |
| 433 part that is included in multiple libraries). | 433 part that is included in multiple libraries). |
| 434 </p> | 434 </p> |
| 435 </dd></dl></dd><dt class="request">analysis.getNavigation</dt><dd><div
class="box"><pre>request: { |
| 436 "id": String |
| 437 "method": "analysis.getNavigation" |
| 438 "params": { |
| 439 "<b>file</b>": <a href="#type_FilePath">FilePath</a> |
| 440 "<b>start</b>": int |
| 441 "<b>end</b>": int |
| 442 } |
| 443 }</pre><br><pre>response: { |
| 444 "id": String |
| 445 "error": <span style="color:#999999">optional</span> <a href="#type_RequestErr
or">RequestError</a> |
| 446 "result": { |
| 447 "<b>files</b>": List<<a href="#type_FilePath">FilePath</a>> |
| 448 "<b>targets</b>": List<<a href="#type_NavigationTarget">NavigationTarget<
/a>> |
| 449 "<b>regions</b>": List<<a href="#type_NavigationRegion">NavigationRegion<
/a>> |
| 450 } |
| 451 }</pre></div> |
| 452 <p> |
| 453 Return the navigation information associated with the given region of |
| 454 the given file. |
| 455 </p> |
| 456 <p> |
| 457 If a navigation region is partially contained in (but extends either |
| 458 before or after) the given region of the file it will be included in |
| 459 the result. This means that it is theoretically possible to get the |
| 460 same navigation region in response to multiple requests. Clients can |
| 461 avoid this by always choosing a region that starts at the beginning of |
| 462 a line and ends at the end of a line in the file. |
| 463 </p> |
| 464 |
| 465 |
| 466 <h4>Parameters</h4><dl><dt class="field"><b><i>file ( <a href="#type_FileP
ath">FilePath</a> )</i></b></dt><dd> |
| 467 |
| 468 <p> |
| 469 The file in which navigation information is being requested. |
| 470 </p> |
| 471 </dd><dt class="field"><b><i>start ( int )</i></b></dt><dd> |
| 472 |
| 473 <p> |
| 474 The offset of the start of the region for which hover information |
| 475 is being requested. |
| 476 </p> |
| 477 </dd><dt class="field"><b><i>end ( int )</i></b></dt><dd> |
| 478 |
| 479 <p> |
| 480 The offset of the end of the region for which hover information is |
| 481 being requested. |
| 482 </p> |
| 483 </dd></dl><h4>Returns</h4><dl><dt class="field"><b><i>files ( List<
<a href="#type_FilePath">FilePath</a>> )</i></b></dt><dd> |
| 484 |
| 485 <p> |
| 486 A list of the paths of files that are referenced by the navigation |
| 487 targets. |
| 488 </p> |
| 489 </dd><dt class="field"><b><i>targets ( List<<a href="#type_Navigati
onTarget">NavigationTarget</a>> )</i></b></dt><dd> |
| 490 |
| 491 <p> |
| 492 A list of the navigation targets that are referenced by the |
| 493 navigation regions. |
| 494 </p> |
| 495 </dd><dt class="field"><b><i>regions ( List<<a href="#type_Navigati
onRegion">NavigationRegion</a>> )</i></b></dt><dd> |
| 496 |
| 497 <p> |
| 498 A list of the navigation regions within the requested region of |
| 499 the file. |
| 500 </p> |
| 435 </dd></dl></dd><dt class="request">analysis.reanalyze</dt><dd><div cla
ss="box"><pre>request: { | 501 </dd></dl></dd><dt class="request">analysis.reanalyze</dt><dd><div cla
ss="box"><pre>request: { |
| 436 "id": String | 502 "id": String |
| 437 "method": "analysis.reanalyze" | 503 "method": "analysis.reanalyze" |
| 438 }</pre><br><pre>response: { | 504 }</pre><br><pre>response: { |
| 439 "id": String | 505 "id": String |
| 440 "error": <span style="color:#999999">optional</span> <a href="#type_RequestErr
or">RequestError</a> | 506 "error": <span style="color:#999999">optional</span> <a href="#type_RequestErr
or">RequestError</a> |
| 441 }</pre></div> | 507 }</pre></div> |
| 442 <p> | 508 <p> |
| 443 Force the re-analysis of everything contained in the | 509 Force the re-analysis of everything contained in the |
| 444 existing analysis roots. This will cause all previously | 510 existing analysis roots. This will cause all previously |
| (...skipping 327 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 772 </dd><dt class="field"><b><i>regions ( List<<a href="#type_Highligh
tRegion">HighlightRegion</a>> )</i></b></dt><dd> | 838 </dd><dt class="field"><b><i>regions ( List<<a href="#type_Highligh
tRegion">HighlightRegion</a>> )</i></b></dt><dd> |
| 773 | 839 |
| 774 <p> | 840 <p> |
| 775 The highlight regions contained in the file. Each | 841 The highlight regions contained in the file. Each |
| 776 highlight region represents a particular syntactic or | 842 highlight region represents a particular syntactic or |
| 777 semantic meaning associated with some range. Note that | 843 semantic meaning associated with some range. Note that |
| 778 the highlight regions that are returned can overlap | 844 the highlight regions that are returned can overlap |
| 779 other highlight regions if there is more than one | 845 other highlight regions if there is more than one |
| 780 meaning associated with a particular region. | 846 meaning associated with a particular region. |
| 781 </p> | 847 </p> |
| 848 </dd></dl></dd><dt class="notification">analysis.invalidate</dt><dd><d
iv class="box"><pre>notification: { |
| 849 "event": "analysis.invalidate" |
| 850 "params": { |
| 851 "<b>file</b>": <a href="#type_FilePath">FilePath</a> |
| 852 "<b>start</b>": int |
| 853 "<b>end</b>": int |
| 854 "<b>delta</b>": int |
| 855 } |
| 856 }</pre></div> |
| 857 <p> |
| 858 Reports that the navigation information associated with a region of a |
| 859 single file has become invalid and should be re-requested. |
| 860 </p> |
| 861 <p> |
| 862 This notification is not subscribed to by default. Clients can |
| 863 subscribe by including the value <tt>"INVALIDATE"</tt> in the list of |
| 864 services passed in an analysis.setSubscriptions request. |
| 865 </p> |
| 866 |
| 867 <h4>Parameters</h4><dl><dt class="field"><b><i>file ( <a href="#type_FileP
ath">FilePath</a> )</i></b></dt><dd> |
| 868 |
| 869 <p> |
| 870 The file whose information has been invalidated. |
| 871 </p> |
| 872 </dd><dt class="field"><b><i>start ( int )</i></b></dt><dd> |
| 873 |
| 874 <p> |
| 875 The offset of the start of the invalidated region. |
| 876 </p> |
| 877 </dd><dt class="field"><b><i>end ( int )</i></b></dt><dd> |
| 878 |
| 879 <p> |
| 880 The offset of the end of the invalidated region. |
| 881 </p> |
| 882 </dd><dt class="field"><b><i>delta ( int )</i></b></dt><dd> |
| 883 |
| 884 <p> |
| 885 The delta to be applied to the offsets in information that follows |
| 886 the invalidated region in order to update it so that it doesn't |
| 887 need to be re-requested. |
| 888 </p> |
| 782 </dd></dl></dd><dt class="notification">analysis.navigation</dt><dd><d
iv class="box"><pre>notification: { | 889 </dd></dl></dd><dt class="notification">analysis.navigation</dt><dd><d
iv class="box"><pre>notification: { |
| 783 "event": "analysis.navigation" | 890 "event": "analysis.navigation" |
| 784 "params": { | 891 "params": { |
| 785 "<b>file</b>": <a href="#type_FilePath">FilePath</a> | 892 "<b>file</b>": <a href="#type_FilePath">FilePath</a> |
| 786 "<b>regions</b>": List<<a href="#type_NavigationRegion">NavigationRegion<
/a>> | 893 "<b>regions</b>": List<<a href="#type_NavigationRegion">NavigationRegion<
/a>> |
| 787 "<b>targets</b>": List<<a href="#type_NavigationTarget">NavigationTarget<
/a>> | 894 "<b>targets</b>": List<<a href="#type_NavigationTarget">NavigationTarget<
/a>> |
| 788 "<b>files</b>": List<<a href="#type_FilePath">FilePath</a>> | 895 "<b>files</b>": List<<a href="#type_FilePath">FilePath</a>> |
| 789 } | 896 } |
| 790 }</pre></div> | 897 }</pre></div> |
| 791 <p> | 898 <p> |
| (...skipping 1142 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 1934 <p> | 2041 <p> |
| 1935 True is hints should be generated as part of generating | 2042 True is hints should be generated as part of generating |
| 1936 errors and warnings. | 2043 errors and warnings. |
| 1937 </p> | 2044 </p> |
| 1938 </dd></dl></dd><dt class="typeDefinition"><a name="type_AnalysisServic
e">AnalysisService: String</a></dt><dd> | 2045 </dd></dl></dd><dt class="typeDefinition"><a name="type_AnalysisServic
e">AnalysisService: String</a></dt><dd> |
| 1939 <p> | 2046 <p> |
| 1940 An enumeration of the services provided by the analysis | 2047 An enumeration of the services provided by the analysis |
| 1941 domain. | 2048 domain. |
| 1942 </p> | 2049 </p> |
| 1943 | 2050 |
| 1944 <dl><dt class="value">FOLDING</dt><dt class="value">HIGHLIGHTS</dt><dt cla
ss="value">NAVIGATION</dt><dt class="value">OCCURRENCES</dt><dt class="value">OU
TLINE</dt><dt class="value">OVERRIDES</dt></dl></dd><dt class="typeDefinition"><
a name="type_AnalysisStatus">AnalysisStatus: object</a></dt><dd> | 2051 <dl><dt class="value">FOLDING</dt><dt class="value">HIGHLIGHTS</dt><dt cla
ss="value">INVALIDATE</dt><dt class="value">NAVIGATION</dt><dt class="value">OCC
URRENCES</dt><dt class="value">OUTLINE</dt><dt class="value">OVERRIDES</dt></dl>
</dd><dt class="typeDefinition"><a name="type_AnalysisStatus">AnalysisStatus: ob
ject</a></dt><dd> |
| 1945 <p> | 2052 <p> |
| 1946 An indication of the current state of analysis. | 2053 An indication of the current state of analysis. |
| 1947 </p> | 2054 </p> |
| 1948 | 2055 |
| 1949 <dl><dt class="field"><b><i>isAnalyzing ( bool )</i></b></dt><dd> | 2056 <dl><dt class="field"><b><i>isAnalyzing ( bool )</i></b></dt><dd> |
| 1950 | 2057 |
| 1951 <p>True if analysis is currently being performed.</p> | 2058 <p>True if analysis is currently being performed.</p> |
| 1952 </dd><dt class="field"><b><i>analysisTarget ( <span style="color:#9999
99">optional</span> String )</i></b></dt><dd> | 2059 </dd><dt class="field"><b><i>analysisTarget ( <span style="color:#9999
99">optional</span> String )</i></b></dt><dd> |
| 1953 | 2060 |
| 1954 <p> | 2061 <p> |
| (...skipping 1436 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 3391 <p> | 3498 <p> |
| 3392 This section contains a list of all of the errors that are | 3499 This section contains a list of all of the errors that are |
| 3393 produced by the server and the data that is returned with each. | 3500 produced by the server and the data that is returned with each. |
| 3394 </p> | 3501 </p> |
| 3395 <p> | 3502 <p> |
| 3396 TBD | 3503 TBD |
| 3397 </p> | 3504 </p> |
| 3398 | 3505 |
| 3399 | 3506 |
| 3400 </body></html> | 3507 </body></html> |
| OLD | NEW |