pkg/analyzer/README.md - Issue 1249443002: Fix the README to point to the right Analysis Server API Specification

Side by Side Diff: pkg/analyzer/README.md

Issue 1249443002: Fix the README to point to the right Analysis Server API Specification (Closed) Base URL: https://github.com/dart-lang/sdk.git@master

Patch Set: Created 5 years, 5 months ago

Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.

Jump to:

View unified diff | Download patch

« no previous file with comments | « no previous file | no next file » | no next file with comments »

OLD	NEW
1 The analysis package defines support for performing static analysis of Dart	1 The analysis package defines support for performing static analysis of Dart

2 code. It was designed to support tooling efforts, but has also been used for	2 code. It was designed to support tooling efforts, but has also been used for

3 such things as statistics gathering and code transformers.	3 such things as statistics gathering and code transformers.

4	4

5 If you are interested in providing Dart support in a long-running tool, such as	5 If you are interested in providing Dart support in a long-running tool, such as

6 an editor or IDE, you should use the analysis server instead of this package.	6 an editor or IDE, you should use the analysis server instead of this package.

7 The analysis server is currently shipped as an executable in the SDK and will	7 The analysis server is currently shipped as an executable in the SDK and will

8 be released as a package in the near future. In the meantime, if you'd like to	8 be released as a package in the near future. In the meantime, if you'd like to

9 learn more about it, please look at the	9 learn more about it, please look at the

10 [Analysis Server API Specification](http://htmlpreview.github.io/?https://github .com/dart-lang/bleeding_edge/blob/master/dart/pkg/analysis_server/doc/api.html)	10 [Analysis Server API Specification](http://htmlpreview.github.io/?https://github .com/dart-lang/sdk/blob/master/pkg/analysis_server/doc/api.html)

11 or contact the mailing list (see below).	11 or contact the mailing list (see below).

12	12

13 The API's in this package are, quite frankly, a mess at the moment. They were	13 The API's in this package are, quite frankly, a mess at the moment. They were

14 originally machine generated by a translator and were based on an earlier Java	14 originally machine generated by a translator and were based on an earlier Java

15 implementation. Several of the API's still look like their Java predecessors	15 implementation. Several of the API's still look like their Java predecessors

16 (or worse) rather than clean Dart API's.	16 (or worse) rather than clean Dart API's.

17	17

18 In addition, there is currently no clean distinction between public and internal	18 In addition, there is currently no clean distinction between public and internal

19 API's. We plan to address this issue soon, but doing so will, unfortunately,	19 API's. We plan to address this issue soon, but doing so will, unfortunately,

20 require a large number of breaking changes. We will try to minimize the pain	20 require a large number of breaking changes. We will try to minimize the pain

21 this causes for our clients, but some pain is inevitable.	21 this causes for our clients, but some pain is inevitable.

22	22

23 Questions and requests for additional functionality are welcome, and can be made	23 Questions and requests for additional functionality are welcome, and can be made

24 by either opening an issue at	24 by either opening an issue at

25 [http://dartbug.com](http://dartbug.com)	25 [http://dartbug.com](http://dartbug.com)

26 or by emailing	26 or by emailing

27 [analyzer-discuss@dartlang.org](https://groups.google.com/a/dartlang.org/forum/# !forum/analyzer-discuss).	27 [analyzer-discuss@dartlang.org](https://groups.google.com/a/dartlang.org/forum/# !forum/analyzer-discuss).

OLD	NEW